Skip to main content

Visual Editor - Widget Library

Learn how to install and customize the Search Result Page and Instant Search widgets on your Shopify storefront - no code required.

Written by Thomas Ta

📖 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.

  1. Click the theme dropdown at the top of the page - it lists all available themes with their name and OS version.

  2. 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

  1. Click Install on the Search Result Page card - you'll be redirected to the Shopify Theme Editor, App Embeds section.
    ​

  2. The Discovery App Embed is pre-selected and the Template ID field is pre-filled.

  3. Click Save in the Shopify Theme Editor.

  4. Return to the Widget Library - the card now shows an Installed status. 📸

Unsupported themes

Clicking Install opens a step-by-step guide popup:

  1. 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.

  2. Locate your theme's Product Grid Selector and enter it in the Clearer Discovery app embed field to replace the default Search Result Page.

  3. 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.

  1. Click Install on the Instant Search Widget card.

  2. Click to enable Discovery App Embed - you'll be redirected to the Shopify Theme Editor, App Embeds section. Click Save.

  3. Click to enable the Clearer Instant Search app embed.
    ​

  4. 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

  1. Click Customize on the Search Result Page card.

  2. 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

  1. Click Customize on the Instant Search Widget card.

  2. 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.

Did this answer your question?