📖 The Widget Library is the central hub for managing how Clearer appears on your storefront. From here you can install, uninstall, and customize two discovery widgets that power your store's search experience - the Search Result Page and the Instant Search Widget.
How to access
To access it, go to Product Discovery > Search > Visual Editor in the app admin.
💡 Only pre-built Clearer widgets are available. Custom widgets cannot be added to the library.
Select a theme
Widget status (installed or not) is tracked per theme, so always confirm your theme selection before making changes.
Click the theme dropdown at the top of the page - it lists all available themes with their name and OS version.
The Live theme is selected by default and appears at the top. Other themes are listed alphabetically.
Install discovery widgets
Search Result Page
This widget replaces your theme's default search results with Clearer's fully customizable Search Result Page. The install flow differs depending on whether your theme is supported.
Supported themes
Click Install on the Search Result Page card - you'll be redirected to the Shopify Theme Editor, App Embeds section.
The Discovery App Embed is pre-selected and the Template ID field is pre-filled.
Click Save in the Shopify Theme Editor.
Return to the Widget Library - the card now shows an Installed status. 📸
Unsupported themes
Clicking Install opens a step-by-step guide popup:
Use the Enable button to go directly to the App Embeds section in the Shopify Theme Editor. The Template ID is pre-filled - enable the Clearer Discovery app embed.
Locate your theme's Product Grid Selector and enter it in the Clearer Discovery app embed field to replace the default Search Result Page.
Click Save in the Shopify Theme Editor.
You can close the popup at any time by clicking the X icon to return to the Widget Library.
Instant Search Widget
This widget displays live search suggestions as customers type in the search bar.
Click Install on the Instant Search Widget card.
Click to enable Discovery App Embed - you'll be redirected to the Shopify Theme Editor, App Embeds section. Click Save.
Click to enable the Clearer Instant Search app embed.
Click Save and return to the Widget Library to confirm the Installed status.
Supported themes and versions
⚠️ Our app is compatible with the themes and versions listed below but does not adopt their individual features. Compatibility with other versions is not guaranteed. If your theme isn't listed or is customized, please contact us for support.
Theme | Supported Versions |
Blockshop | 10.0.0, 11.0.0 |
Broadcast | 5.0.0, 6.0.0 |
Colorblock | 15.0.0, 16.0.0 |
Craft | 15.0.0, 16.0.0 |
Crave | 15.0.0, 16.0.0 |
Dawn | 15.0.0, 16.0.0 |
Ella | 6.0.0, 7.0.0 |
Empire | 11.0.0, 12.0.0 |
Expanse | 5.0.0, 6.0.0 |
Flex | 5.0.0, 6.0.0 |
Flow | 39.0.0, 40.0.0 |
Focal | 12.0.0, 13.0.0 |
Icon | 11.0.0, 12.0.0 |
Impulse | 7.0.0, 8.0.0 |
Motion | 10.0.0, 11.0.0 |
Prestige | 10.0.0, 11.0.0 |
Refresh | 15.0.0, 16.0.0 |
Ride | 15.0.0, 16.0.0 |
Sense | 15.0.0, 16.0.0 |
Streamline | 6.0.0, 7.0.0 |
Studio | 15.0.0, 16.0.0 |
Symmetry | 7.0.0, 8.0.0 |
Taste | 15.0.0, 16.0.0 |
Testament | 13.0.0, 14.0.0 |
Turbo | 9.0.0, 10.0.0 |
Venue | 14.0.0, 15.0.0 |
Warehouse | 6.0.0, 7.0.0 |
Customize discovery widgets
Search Result Page
Click Customize on the Search Result Page card.
In the editor sidebar, navigate to the Styles icon and select Colors. Available settings include:
General: Background, Lines & Dividers
Text: Heading, Label text, Body text, Secondary text, Links & Actions
Price: Regular price, Sale price, Compare-at price, Saving text
Button: Regular price, Sale price, Compare-at price, Saving text
Others: Theme-specific elements that vary by template
Instant Search Widget
Click Customize on the Instant Search Widget card.
Choose your preferred layout:
Split view (default)
Full width view
Single view
💡 Remember to click Save settings after customizing - changes won't appear on your store until saved.
Feel free to reach out to our support team via chat if you have any questions or need additional assistance.








