You can create and modify the AddSearch Recommend Global Widget with the Block Designer. It allows you to customize its appearance and set up filters to fine-tune the recommendations you want to display.

For instance, you can use the Global Widget to show items in a similar price range, web pages related to specific products, recently added products based on their dates, or other content the user may not have considered earlier.


Setting up the Global Widget entails 1) choosing the block and templates in the Block Wizard, 2) configuring the block in the Block Designer.

When you have configured the block for the Widget, you can publish it with a script on your website. Also, you can come back to edit the block from the AddSearch Recommend main page by clicking on the Edit link of the block you want to modify.

To set up the Global Widget, follow these instructions:

  1. Log in to your AddSearch account
  2. Go to Recommendations under Manage results
  3. Click the Add new button to open the Block Wizard

addsearch recommend main screen ui.

1. Configuring with Block Wizard

Before entering the Block Designer, the Block Wizard requires selecting the block type and template for the block.

  1. Click the On any page link to create Global Block
  2. Click Continue to designer to go to enter the Block designer

addsearch recommend create new block ui.

  1. Input the block name in the Block title field
  2. Click on any of the pre-defined Templates or Start from scratch
  3. Click Continue to designer to enter the Block Designer

addsearch recommend create new global block ui.

2. Configuring with Block Designer

The Block designer consists of A) Basic Settings and B) Content & Filtering settings you can configure.

A. In the Basic settings section you can:

  • Modify the title under the Block Title section (not displayed to the user)
  • Select the widget type from Grid, List, or Carousel layouts under the Content section
  • Set the widget header to be shown as the title of the Global Widget (displayed to the user in the Widget)
  • Specify the currency format for the price field
  • Assign or hide specific fields in the Product Details section

addsearch recommend basic and content and section ui.

B. In the Content & Filtering section you can:
  • Define the number of items to be displayed in the Product Widget
  • Set the sorting method in the Content section
  • Choose the method for joining filters and set the filter rules

addsearch recommend content and filtering ui.

Choosing the method of joining filters

  1. Set the Number of items displayed in the Global Widget and sorting method in the Content section
  2. The Filtering rules section includes a drop-down menu to select for ‘AND’ and ‘OR’ that allow for you to choose how filters are joined
    • ‘AND’ means all selected filters must be satisfied
    • ‘OR’ means at least one of the selected filters must be satisfied

Adding the filtering rule

  1. Click the + Add rule and Based on items attribute buttons to create the rule
  2. On the rule, click the pencil icon to edit the rule
  3. Select the desired field (e.g., title, h1, price, date)

The filtering rule is context-dependent and varies based on the type of the indexed field being used:

  • Text (e.g., color, manufacturer, top-sellers):
    • Field ‘Contains’ and does ‘Not contain’ options require you to input the text you want to match
  • Number (e.g., prices, sizes, star ratings):
    • ‘Between’, ‘Greater than’, and ‘Less than’ options require you to input a number
  • Date:
    • ‘Within the last’ option requires you to input a number and select either ‘Days’, ‘Weeks’, or ‘Months’ from the drop-down menu
    • ‘Between’ requires you to choose dates using the date pickers
    • ‘Before’ and ‘After’ options require you to choose a date with a date picker

Please note that you can create a maximum of three rules for each block.

addsearch recommend editing filters ui.

3. Publishing

Once you have configured the block, click Save and preview to submit the changes and preview the recommendations. You can publish the block when you’re done with the configuration and want to add the Global Widget to your page. Please note that if you make changes after publishing, you will need to publish again for the changes to take effect on your website.

  1. Click the Publish button located at the top right of the Block Designer page
  2. Confirm your action by clicking Yes when asked if you want to publish the block configuration
  3. Copy the generated script that appears and add it to your website to implement the changes

After you have closed the script prompt by clicking outside the prompt, you can retrieve the script again by clicking the Show Script button at the top right of the Block Designer page.

Please visit our documentation here on installing the AddSearch Recommend Widget to your web page.

Was this helpful?

Need more help?

We’re always happy to help with code or other questions you might have. Search our documentation, contact support, or connect with our sales team.