Skip to main content

Setting up Clearer on Theme OS 1.0 (unsupported themes)

Set up Clearer on a Theme OS 1.0 store by enabling the app embed and adding render tags to your theme code.

Written by Thomas Ta

📖 This guide covers stores whose theme does not support Clearer's app blocks and sections directly. These are older Theme OS 1.0 themes, such as Debut.

⚠️ This setup involves editing your theme code. We recommend duplicating your live theme and working on the copy first, so you can preview changes safely before publishing.


Initial setup

Enable the Clearer app embed

  1. In Shopify admin, go to Online Store > Themes > Theme editor > App embeds for the theme you want to add Clearer to.

  2. Toggle on Clearer.io Discovery.

  3. Click Save.

⚠️ Widgets on the storefront only render once Clearer.io Discovery is enabled here. This step is required regardless of what you do in the theme code below.

Create the clearer-app snippet

  1. In Shopify admin, go to Online Store > Themes > Edit code > Snippets.

  2. Create a new Liquid file named clearer-app (the editor adds .liquid for you).

  3. Paste in the following code and save:

{% comment %} PLEASE DO NOT EDIT THIS FILE {% endcomment %}
{% case type %}
{% when 'product-filter' %}
<div class="boost-sd__filter-product-list"></div>
<script>
if (window.boostSDTaeUtils && window.boostSDTaeUtils.initCollectionFilter) {
window.boostSDTaeUtils.initCollectionFilter();
}
</script>

{% when 'recommendation' %}
<div id="boost-sd-widget-{{- widgetId -}}"></div>
{% endcase %}


Collection page with filters

  1. (Optional but recommended) Back up the original file first. In Templates, create collection.clearer-original.liquid and paste the current contents of collection.liquid into it.

  2. Open Templates > collection.liquid. Wrap the existing code in a comment block so it is kept for reference:

{% comment %} Original code goes here. {% endcomment %}

3. Add this line at the end of the file and save:

{% render 'clearer-app', type: 'product-filter' %}

Preview the collection page afterward to confirm filters render where expected.


Search page with filters

Same pattern as the collection page:

  1. (Optional) Back up search.liquid to search.clearer-original.liquid.

  2. Open Templates > search.liquid, comment out the original code, then add:

{% render 'clearer-app', type: 'product-filter' %}

3. Save and preview the search page.


Instant search widget

  1. Go to Theme editor > App embeds.

  2. Toggle on Clearer.io Instant Search.

  3. Click Save.

The search overlay activates as soon as a shopper clicks the search box. No code changes are needed for this one.


Recommendation widget

Add the recommendation render tag to the end of whichever templates should show a recommendation widget:

{% render 'clearer-app', type: 'recommendation', widgetId: 'Replace widgetId here' %}

Page

Template file

Homepage

index.liquid

Product

product.liquid

Collection

collection.liquid

Cart

cart.liquid

⚠️ The widgetId must match the widget ID configured in the Clearer app admin. For example, homepage-12918 should only be used on index.liquid, otherwise the widget renders empty.


Predictive bundles

Add the predictive bundles code to the end of whichever templates should show a predictive bundle widget:

<div class="boost-sd-widget-predictive-bundle boost-sd__predictive-bundle-wrapper"></div>

Page

Template file

Product

product.liquid

Collection

collection.liquid


Review your setup

After saving, preview the storefront for each page you touched (collection, search, home, product, cart) to confirm the corresponding widget appears. Then double-check that the matching settings in the Clearer app admin (filters, search layout, recommendation widgets) line up with what you just wired into the theme.


Feel free to reach out to our dedicated support team via chat with any further questions.

Did this answer your question?