Learn about Recommendation widgets, their types, and available settings in the Using Recommendations guide.
If your store uses themes that support theme app blocks, you’ll see the Theme blocks tab in the Merchandising & Promo > Recommendations section. From there, you can add Recommendation widgets to your theme using app blocks in the Theme Editor.
- Recommendation app blocks can only be added to themes where the app is activated. To check whether the app is active in a theme, go to the Search & Navigation > Preferences section > Themes tab.
- Products by Attribute widgets are not currently available as app blocks. To use them, add them through the Vintage widgets tab instead.
- We recommend adding app blocks through the app admin rather than directly in the Theme Editor. This allows you to view all Recommendation widgets and their statuses in one place and quickly navigate to their locations in the Theme Editor.
Add a widget
To add a Recommendation widget to your theme using an app block:
- Go to Searchanise Search & Filter control panel > Merchandising & Promo > Recommendations section > Theme blocks tab.
- Click Add in the top-right corner.
- In the installation dialog, select the widget type, theme, and page where you want to place the widget, then click Install.
- The Theme Editor will open with the selected app block. Configure the widget settings (click on the selected app block on the left side to see the settings):
- Optionally, change the Title.
- For Featured Products, select the products to display.
- For Similar Products, choose a value for the Based on setting.
- For Recently Viewed Products, specify how long viewed products should remain visible.
- Optionally, move the block to a different position on the page.
- Click Save in the Theme Editor.
- Return to the apps Recommendations section > Theme blocks tab, and click the Sync block button.
Once the synchronization is complete, the widget will appear in the list with its title and an Active status. The Recommendation widget will also be displayed on the selected page in your storefront theme.
To display the widget in another location, repeat the steps above and select a different page or theme during installation.
Widget statuses
You can view the status of each Recommendation widget in the Theme blocks tab. The status is synchronized with the corresponding app block in your theme.
- Active — the app block is installed and visible.
- Hidden — the app block is installed but hidden.
- Missing — the app block isn’t installed.
Hide a widget
To hide a Recommendation widget:
- Go to Searchanise Search & Filter control panel > Merchandising & Promo > Recommendations section > Theme blocks tab.
- Click Edit next to the block.
- The Theme Editor will open with the corresponding app block selected.
- Hide the app block in the Theme Editor and save your changes.
- Return to the apps Recommendations section > Theme blocks tab, and click the Sync block button.
The widget’s status in the admin panel will change to Hidden, and it will no longer be displayed to shoppers.
Activate a widget
To activate the hidden Recommendation widget:
- Go to Searchanise Search & Filter control panel > Merchandising & Promo > Recommendations section > Theme blocks tab.
- Click Edit next to the block.
- The Theme Editor will open with the corresponding app block selected.
- Activate the app block in the Theme Editor and save your changes.
- Return to the apps Recommendations section > Theme blocks tab, and click the Sync block button.
The widget’s status in the admin panel will change to Active, and it will be displayed to shoppers.
Edit a widget in Theme Editor
To edit a Recommendation widget:
- Go to Searchanise Search & Filter control panel > Merchandising & Promo > Recommendations section > Theme blocks tab.
- Click Customize next to the block.
- The Theme Editor will open with the corresponding app block selected.
- Update the app block settings as needed.
- Save your changes in the Theme Editor.
- Return to the apps Recommendations section > Theme blocks tab, and click the Sync block button.
Delete a widget
To delete a Recommendation widget:
- Go to Searchanise Search & Filter control panel > Merchandising & Promo > Recommendations section > Theme blocks tab.
- Click Edit next to the block.
- The Theme Editor will open with the corresponding app block selected.
- Remove the app block and save your changes.
- Return to the Theme blocks tab, and click the Sync block button. The widget status will change to Missing.
- Click Delete next to the block and confirm the action.
The widget will be removed from both your theme and the Searchanise admin panel.
