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
From app admin, go to Product discovery > Recommendations > Widgets
Click Create now
Choose where you want the widget to appear (Homepage / Collection / Product / Cart)
Select Hand-picked products
Click Next
Define rules (main products > recommended products)
In the rule builder, select your main product(s)
Click Add recommended products
Use Search recommended products to select a product
Repeat to add more recommended products
To remove a product, click the trash bin icon.
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
Preview your widget.
Click Save & next when ready.
Adjust:
Enter a Widget name
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
In Shopify Admin, go to Online Store > Themes
Click Customize
Open App embeds
Toggle ON Clearer.io Discovery (or similarly named Clearer embed)
Click Save
Add the “Recommendation” app block
In Shopify theme editor, navigate to the page template where the widget should appear
(Homepage / Collection / Product / Cart)Click Add block (or Add section, depending on the template)
Select the Clearer app block named Recommendation
In the block settings, paste/select the Widget ID from Clearer
Click Save
Verify your widget is live
Open your storefront
Navigate to the page you installed the widget on
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.








