Skip to main content

Hand-picked product recommendations widget

Manually define which products should be recommended for specific “main” products.

Written by Thomas Ta

Hand-picked product recommendations let you define your own “if/then” rules-so you can fully control what is recommended in each scenario.


Where this widget can appear

Hand-picked recommendation widgets are available on:

  • Homepage

  • Collection page

  • Product page

  • Cart page


Start creating the widget

  1. From app admin, go to Product discovery > Recommendations > Widgets

  2. Click Create now

  3. Choose where you want the widget to appear (Homepage / Collection / Product / Cart)

  4. Select Hand-picked products

  5. Click Next


Define rules (main products > recommended products)

  1. In the rule builder, select your main product(s)

  2. Click Add recommended products

  3. Use Search recommended products to select a product

  4. Repeat to add more recommended products

  5. To remove a product, click the trash bin icon.
    ​

  6. To add a new rule group, click Add rule.

⚠️ Important limitations

  • Each product can only have one rule applied at a time. If you can’t find a product, check whether it already has an existing rule.

  • Max 15 recommended products for one main product.

  • If multiple main products share the same “Then” consequence, add them to the same rule group.

  • Max 150 rule groups per widget.

  • Cart page: IF conditions based on items already in the cart are not yet supported.

  • Homepage placement: you can add only one rule.

7. Click Next


Preview and adjust display settings

  1. Preview your widget.

  2. Click Save & next when ready.

  3. Adjust:

    • Maximum recommendations

    • Number of products per row on PC

  4. Enter a Widget name
    ​

  5. Click I'm all done to finish.


Install the widget on your Shopify theme

This step happens in Shopify’s theme editor. You must:

Enable the “Clearer.io Discovery” app embed

  1. In Shopify Admin, go to Online Store > Themes

  2. Click Customize

  3. Open App embeds

  4. Toggle ON Clearer.io Discovery (or similarly named Clearer embed)

  5. Click Save

Add the “Recommendation” app block

  1. In Shopify theme editor, navigate to the page template where the widget should appear
    (Homepage / Collection / Product / Cart)

  2. Click Add block (or Add section, depending on the template)
    ​

  3. Select the Clearer app block named Recommendation

  4. In the block settings, paste/select the Widget ID from Clearer

  5. Click Save

Verify your widget is live

  1. Open your storefront

  2. Navigate to the page you installed the widget on

  3. Confirm:

    • The widget renders

    • The recommended products match your rules

    • Product cards load correctly

If the widget does not appear:

  • Confirm the App embed is enabled

  • Confirm the widget was added to the correct template (Product vs Collection vs Cart)

  • Confirm the Widget ID matches the widget you created


Manage a hand-picked recommendation widget

From the widget list, click the … icon in the Actions column to:

  • Edit

  • Duplicate

  • Delete


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

Did this answer your question?