📖 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
In Shopify admin, go to Online Store > Themes > Theme editor > App embeds for the theme you want to add Clearer to.
Toggle on Clearer.io Discovery.
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
In Shopify admin, go to Online Store > Themes > Edit code > Snippets.
Create a new Liquid file named
clearer-app(the editor adds.liquidfor you).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
(Optional but recommended) Back up the original file first. In Templates, create
collection.clearer-original.liquidand paste the current contents ofcollection.liquidinto it.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:
(Optional) Back up
search.liquidtosearch.clearer-original.liquid.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
Go to Theme editor > App embeds.
Toggle on Clearer.io Instant Search.
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 |
|
Product |
|
Collection |
|
Cart |
|
⚠️ 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 |
|
Collection |
|
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.





