Merchandising Category Pages
On this page
Algolia Category Merchandising capabilities include:
- Pin and hide items
- Boost, bury, and filter categories
- Display banners
- Merchandise based on applied filters, date range, geolocation, device, and user segment
For more information, please refer to the Category Merchandising Features Overview section of this page.
This guide gives you an overview on how to merchandise category pages using the visual and manual editors in the Algolia dashboard. It also gives you an overview of how to do so using Algolia’s API Client or REST API.
The guide doesn’t cover the steps to implement and merchandise category pages using the Magento or Shopify extensions. You can learn about those extensions on these pages.
There are two-steps to implement this solution.
- Build the category pages with Algolia
- Merchandise the category pages with Algolia
1. Build the category pages with Algolia
To merchandise category pages with Algolia, you must first create category pages powered by Algolia. You can find the detailed steps in the guide on how to implement category pages with Algolia.
2. Merchandise the category pages with Algolia
Algolia offers three ways to merchandise :
- Using the Visual Editor in the dashboard
- Using the Manual Editor in the dashboard
- Build your own custom merchandising UI using the Rules API
Category merchandising features overview
|Visual Editor||• Pin and hide items
• Boost, bury, and filter categories
• Set priority on category ordering
• Ban categories of items
• Merchandise on filter selection
• Merchandise based on date range, for time-limited promotions
• Merchandise based on geolocation, device, user segment
• Configurable preview UI
|Manual Editor||• Display banners
• Merchandise on filter selection
• Facet Merchandising (Facet type and value reordering)
|Build your own custom merchandising UI
using Algolia’s Rules API
|• Be creative with the features made available with Algolia’s Rules API|
Using the Visual Editor in the dashboard
You can navigate to this page through these steps:
- Select the Rules section from the left sidebar menu in the Algolia dashboard.
- Under the heading Rules, select the index you are adding a Rule to.
- Select New rule. In the dropdown, click on the Visual Editor option.
To start merchandising a category, you need to tie a filter value to a promotional rule to trigger the Rule on a category page. In this guide,
categoryId is a facet attribute available in each product record. It’s a unique identifier that links to all category pages the product is tied to. The name of this facet attribute can change depending on your data structure, such as
Please check with your data team to make sure you’re referencing the correct filter name. This filter is the facet value your engineering team uses to query the products on the front-end category page. Learn more about category page identifiers.
In the UI, you need to set a Condition and a Consequence of a rule.
- Under It all starts here section, select Set condition.
- Under Filters, Pick
categoryIdunder Filter name and select the category page you want to merchandise under Value.
Under What do you want to do section, select any of the options in the menu or start to drag them to the preview UI to start merchandising.
Using the Manual Editor in the dashboard
The manual editor is flexible when it comes to category merchandising. There are a variety of different use cases you can build with the manual editor, such as adding a banner on filter selection and facet merchandising. This is covered in depth in a separate section – coming soon.
Build your own custom merchandising UI using the Rules API
You can build your own UI on top of Algolia’s Rules API. Here are some useful resources to help you with that: