> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://www.guides.helpfulcrowd.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Installing HelpfulCrowd: Shopify

## Installing app

Go to [https://apps.shopify.com/helpfulcrowd](https://apps.shopify.com/helpfulcrowd) and click [Add App](https://apps.shopify.com/helpfulcrowd).

![](https://storage.crisp.chat/users/helpdesk/website/86be788ed79d580/b9f9b496-62e6-4b51-a7c4-7fd6eb_1ligpwd.gif)

Great! At this point HelpfulCrowd is installed on your store and your next customer can already leave a review.  

## Adding snippets to theme

Like many similar apps, HelpfulCrowd needs to add files and code to your store theme so that our app provides best experience for you and your customers. 

**Note:**  
_i) If your reviews aren't showing up on your site, it's probably because the snippets **have not been added** to your theme._  
_ii)  If you **change themes**, we'll automatically try to inject the widgets again but they may need to be added manually as the snippets are only added to the current theme._ 

### Automatic installation - troubleshooting

We try to do some heavy lifting for you with our automatic installer.

 If your theme is **modified** or a **paid theme**, then we may not be able to automatically inject our code. In this case, then you can either:

1.  Provide staff access to the email account **team@helpfulcrowd.com
2.  Attempt to add the widget snippets manually.

### Adding snippets manually

1.  Goto Settings > Widgets
2.  Identify the missing widget
3.  Copy the 'Shopify' embed code
4.  Paste it into the correct theme file and location

To do that you will now need to open your theme editor in your Shopify Dashboard. This is found under **Online Store > Themes | Actions > Edit Code**  

![](https://storage.crisp.chat/users/helpdesk/website/221fb91418f7fc00/3ca4ef79-af3f-42e9-b774-315f67_1vvvn5b.gif)

**Pro tip:** _Open **theme editor** in a **new browser tab** to simplify copying & pasting and also open your **Storefront** in a **new browser tab** so you can see the changes._

Now that you are in theme editor, it's time to add our code to your theme according to the instructions provided in the setup guide or for each widget under Settings > Widgets. All snippets, **Product Summary / Product Tabs / Product Rating** and **Optional Widgets,** need to be inserted into **different files** and **specific locations** in those files to display correct (or at all!) 

We have done our best to make everything as automated as possible, but because every theme developer creates different themes and uses different techniques on how they build their themes, we cannot advise on which files the snippets need to be inserted into and which location. 

If you are uncomfortable or not sure about how to edit your theme, then either reach out to the theme developer, your Shopify expert or us to lend a hand!  


## A few things to keep in mind

*   **Product Rating** widget **will be hidden** until you receive and publish your first review. 
*   If you switch or change your theme, then we will try to inject the theme again, but you may need to add the HelpfulCrowd code snippets again, as they are only added to a current theme