How to set up Hand-picked products recommendation

📖 In this guide, we will walk you through the process of setting up Hand-picked Boost AI Search & Discovery Recommendation widgets to enhance your storefront's appeal and functionality.

⚠ This feature only works with Boost AI Search & Discovery V3. To find out which version of our app you are using, please follow this article.

On this page


Understanding Hand-picked products recommendation

Manual settings help you manually pick or modify the recommended products appearing in a recommendation widget.

It can be applied to this type of recommendation:

  • Hand-picked products: Manually select up to 15 recommended products and set up their orders in this widget.

Create hand-picked products recommendation

To create a hand-picked product widget in the app’s dashboard:

  1. Go to Recommendation > Recommendation widgets.

  1. Click Add new widget.
  2. On the Recommendation type section, select Product page > select Hand-picked products > click Next.

⚠ Currently, Hand-picked recommendation is only available for Product page.


  1. In the Recommendation settings menu, in Conditions section, click the Search products box to select the main product(s) that you'd like to display the Hand-picked recommendation on its product pages. To select the list of products that are included in the widget, click Search products in Consequences section and repeat the same step.

  • Each product can only have one rule (list of recommendations) applied at the time. In case you can't search for a product here, please check if it already has an existing rule.
  • There are a maximum of 15 recommended products for one main product.
  • Main products with the same Consequences should be added to the same rule group. For each widget, you can set up to 100 rule groups.
  1. Click Add product to complete your action, or Cancel to cancel.
  2. To delete a product, click the trash bin icon button.

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

  1. Click Next.
  2. Edit the display of your widget. Preview then if you're satisfied with what you're looking at, click Save & next.
  3. Complete the last two required steps:
    • Step 1: Enable app embed "Boost Core". You can watch this tutorial video for instruction.
      • Go to Shopify Admin > Sales channel > Online Store > Themes > Customize > App embed > Enable Boost app embed.


    • Step 2: Add the app block "Boost Recommendation"
      • Please add the app block “Boost Recommendation” to the page. Make sure to paste the widget ID productpage-xxxxxx into the block to display the proper recommendation widget. You can watch this tutorial video for instruction.


  1. Click I'm all done to finish.

Edit a hand-picked product recommendations widget

Widget layout

Adjust the Maximum recommendations / Number of products per row on PC by inputting your desired amount or clicking the arrow buttons.

Widget title

  1. Enter your widget's name into Widget name box.

  1. Style - you can select from two options:
    • Default design settings (no further action required)
    • Customization: create your own custom widget.
      • Alignment: Left/Center.


      • Text: custom text style. Learn more how to adjust them here.

      • Tick Save Widget title settings above as Default to if you'd like to keep this settings for all your next widgets after.

💡 You can change design elements of the widget from our theme settings. Go to Theme > Set up the feature on theme (if you have yet to) > Edit visual design > Customize the settings on Product item section.


Tutorial Video

Watch our tutorial video to see how to set up Product Recommendation Widget:


If you have any questions or need further assistance, please do not hesitate to reach out to our dedicated support team at support@boostcommerce.net.