Skip to main content

Documentation Index

Fetch the complete documentation index at: https://algolia.com/llms.txt

Use this file to discover all available pages before exploring further.

The Visual Category Merchandising tool lets you customize product display on Algolia-powered category pages, which can help improve your online store’s . You can find this tool on the edit page of a category, in the Algolia Merchandising tab. For more merchandising features, see Visual merchandising.

​
Merchandising

The Visual Merchandiser lets you manage the order in which products are shown on a category page. Through the drag-and-drop feature, or the arrow keys, products can be moved up or down in the hierarchy to move them to the desired position. Screenshot of the 'Visual category merchandising' page showing a table of products in the 'Gear' category with position, image, ID, SKU, name, price, and pin options. Products can be pinned to a position. This means this product always shows up at the position it’s pinned. To unpin a product, click Un-pin. The Visual Merchandiser only displays the first page of results in the admin section of Magento. To pin products from any other page, use the autocomplete menu to find the desired product. This autocomplete menu only shows products from the current category. When you select a product from this menu, it’s automatically pinned to the first position. You can move the product up or down for pinning it to other positions. Screenshot of a search autocomplete menu showing 'Sprite' products like 'Sprite Yoga Companion Kit' and 'Sprite Foam Roller' with prices.
All pinned positions are saved when the whole category is saved.

​
Rules

The Visual Merchandising Tool uses Rules to pin products to a certain position. To preserve the position of these products, a query rule is created for every category with at least one pinned product.
Last modified on March 12, 2026