The PureClarity Shopify application will integrate your shop with PureClarity. It will:

  1. Synchronise your shop data with PureClarity so that it can provide personalised merchandising. This includes your products, collections, orders and customers.
  2. Add the PureClarity liquid snippets into your selected themes, and add areas to them to show PureClarity recommendations and personalised content.


Once you have installed the application your store needs to synchronise with PureClarity so that PureClarity can learn about your products, collections and customers. This process will start automatically after the application is installed onto your site, as shown:

During this process, our app will update you with the status of the synchronisation. You may leave the application and come back later if required. It may take a while to fully sync due to the speed PureClarity can request data from Shopify.

When the synchronisation has been completed the “Linking your store to PureClarity” section will be hidden and the status bar will change to “Store Linked”, as shown:


When you signed up you had the option of selecting a theme that PureClarity will be installed on. If you didn't select a theme you can choose the themes PureClarity will be installed on in the "Themes" area of the app. PureClarity will do the following when installed on a theme:

  • Add our liquid snippets to the theme
  • Add a reference to our JavaScript inside the <body> of the page (located in layout/theme.liquid)
  • Add our zone snippet into several files. These are where the recommendations will be shown. The files we alter are:


  • The zone snippets are added to the bottom of each file. You may want to edit the theme manually to adjust the location of each zone. You can also add more zones, and add zones onto other pages. This is discussed in the section Altering Your Theme below.


The next step is to enable PureClarity by pressing the Enable button, as shown in the following image.

This will activate our JavaScript. PureClarity will start to track activity of users on your site, and collect information about the orders they make. Personalised content including recommendation, images and pop ups will then be shown to your customers.


Once PureClarity is enabled, you can start to use all of our features. We recommend you book a call with our Customer Success team. You can book a time that is best for you directly from our app!

In the app and our Admin area you can find a list of recommended Next Steps. Each is a personalised recommendation for what you can do next in PureClarity. This includes:

  • Setting up the AI recommender campaigns
  • Setting up unique experiences for different customer segments such as "first time visitors".
  • Creating personalised pop ups
  • Enabling our integrated live chat
  • Setting up email campaign widgets, so you can show personalised recommendations to your customers when you email them

Over time more suggestions appear in the app and our Admin, so make sure you keep coming back.


The app shows a summary of some useful analytics, which are updated in real time. You can find more detailed analytics by following the links from the app to our Admin.


Recommenders can be styled to match the design of your site. We provide a number of out of the box Recommender Templates that you can adapt. You can edit the Recommender Templates in the PureClarity admin. More information can be found in our template documentation. Please contact support if you need help styling up the recommendations to match your site.


We recommend that you make a copy of your current store theme before starting this. This allows you to be confident of how PureClarity will look before you use it on your live site.

To make a copy of your Theme, go to:

Online Store -> Themes

Your current theme will be shown. Click the “Actions” button and click “Duplicate”.

Follow the instructions above under Working With Themes to install PureClarity on the duplicate theme.

Next, on the duplicated theme (which will be shown below your current theme), click “Actions” and then “Edit code”.


PureClarity Merchandising zones are used to show personalised content to your customers. These can be recommenders (such as “Suggested for You”) – image banners, carousels, or custom HTML. The content is setup in the PureClarity admin.

To include zones on your site – all you need to do is find where in your liquid templates you want to show the zones and add the following snippet:

{% include 'pureclarity-zone' with id:'' %} 

Replace with the zone reference you want. PureClarity comes with some merchandising zones setup out of the box for you. These are set to show personalised recommendations. Simply add the pureclarity-bmz reference as required, and use the following references:

Homepage: HP-01, HP-02, HP-03, HP-04

Product Page: PP-01, PP-02

Basket Page: BP-01, BP-02

PureClarity can show up to 8 zone’s per page, but 4 is usually enough. There are many other page types you can add zone’s to. Please see our Best Practice Guide on the placement of merchandising zones on your site.


PureClarity allows you to promote brands (Shopify Vendors) on your site. PureClarity will show brands in the following area:

  • Brand Recommenders – PureClarity will show appropriate brand recommenders in the merchandising zone. These include recommenders such as, “Recommended Brands for You” and “Best Selling Brands”.

In order to use these, PureClarity looks for Collections that are setup with a single rule – “Product Vendor is equal to “. Collections like this are interpreted as being “Brands”, and the Name, Description and Image of the collection will be used for the brand. If you don’t want to show brand recommenders, then you can turn them off from the PureClarity admin, under “Configuration” – “Recommenders”.

You might already have collections setup for this. If not then you can create them and PureClarity will automatically start to use them.



Once you are happy with the site, and the PureClarity integration – simply make your theme the live theme on your site. To do this:

  1. Go to “Online Store” -> “Themes”
  2. On your copied theme, click on “Actions” and then “Publish”



PureClarity offers a tiered pricing structure. You can find out more about our pricing on our pricing page. You can sign up by selecting the most appropriate plan from the "Billing" section of the app. If your usage goes over the maximum for your chosen plan you will be prompted via email and in the app to upgrade to a higher plan.

During this time PureClarity will attempt to contact you in order to solve this issue and answer any questions you might have regarding the payment increase. Eventually, if after a notable amount of time we have failed to make contact or the increase has not been authorised, we may suspend the service until this issue is resolved.



To avoid any errors occurring on your site after uninstalling the app, the first step is to remove any PureClarity snippets that you have added to any of your pages. Please see the section above, Working With Themes that lists the files PureClarity automatically installs.

Note that you can use the Theme page of the app to remove any automatically inserted assets and zones. For any zones that you have manually added, these will need to be manually removed. To do this go to the “Online Store” section of the Shopify Admin, click the “Actions” button and select “Edit Code”. Go to any file that contains PureClarity snippets (files that have been edited can be identified by looking for the small purple circle next to the name of the file) and remove the snippet from the file, remembering to save after each edit.

Finally, go to the “Apps” section of your Shopify Admin, find the PureClarity Application inside of the “Installed apps” section and click the uninstall application button to the far right of the application name, as shown in the following image:

PureClarity will be uninstalled, and data associated with your store and your users will be deleted. Please note that PureClarity is fully GDPR compliant.

We'd love if you could let use know why you're uninstalling as this helps us improve our offering so we that can deliver the best possible service.

Did this answer your question?