Group Merchandising

This guide introduces you to the Group Merchandising functionality.

What is Group Merchandising


Dynamic grouping feature allows you to group similar products together, such as products of the same type, products of the same color, and so on.

Group merchandising feature further allows you to merchandise product groups as well as products within the groups based on your unique business needs.

Grouping similar products together makes product discovery a breeze! Shoppers don’t need to scroll through long lists of products. They can quickly navigate to the group of their interest and explore the merchandised products within the group. Such browsing convenience eventually leads to more conversions.

Group Merchandising also allows you to optimize the ranking of product groups as per your business goals. For example, you noticed that the “Jeggings” product group is trending on the "pants" search page. You can boost the “Jeggings” product group to position 1 and turn the trend into sales.

Feature Scope

The Group Merchandising feature powers your Search and Category pages.

How does Group Merchandising work end to end


Group merchandising requires the following workflow:

API Side for rendering results

  • Firstly, you’ll need to integrate your site to apply grouping on the API.

API request - Pass the “groupby = attribute” parameter in the request. E.g., groupby=product_brand

API response - Read the grouped API response. This is different from the regular Search API response. Visit this article to learn more.

Dashboard Side for merchandising groups

Applying Group Merchandising rules to the API

  • For group rules on the dashboard to apply to the API request, the API requests must have the groupby param with the attribute value you specified on the dashboard. Suppose you saved a Group rule for a ‘category_id=dresses’ with groupby=product_brand. This rule will only apply when the API request for the category ‘dresses’ has the parameter groupby=product_brand.