The Primary List lets you control which products appear on a page and how they behave. By managing the Primary List, you decide which products are included, how they are ranked, and whether they should be enriched with keywords. This gives you direct control over visibility and search impact across your site.
The Primary List is always connected to a page, but it works independently as a product selection. The page acts as a container, while the Primary List controls the actual products displayed. The Primary List defines the main product selection shown on a category or landing page. When a customer visits the page, products from the Primary List are displayed according to the configured settings.
How to add a Primary list to a page
- Go to Experience > Pages > Category and Landing pages >
- From the list, open the relevant category or landing page. You open it by by clicking on its row.
- Click Add content
4. In the dropdown list, select Primary list, and click Add
How to work with Primary lists
Think of the Primary List as your working area for product exposure.
Start by defining the right Product selection for the page
Let Elevate handle ranking automatically
Use Primary List tools like slices, temporary keywords, or overrides when you need more control
The Primary List toolbar
From the Primary List toolbar, you can access the main areas for managing your product list:
Product selection
This is where you define which products appear on the page. Click Product selection, to use either a manual or rule based selection to define which products are included in the list. When you use the rule based selection, you can either exclude or include based on product attributes. This is the foundation of the Primary List - everything else builds on this selection.
Slices
Slices let you create sections within your product list. Use slices to highlight specific products in a defined area. You can also use slices to apply rules or merchandising logic to a part of the product list. A slice is essentially a segmented area inside the product list where you can take more control. Read more in the dedicated help article.
List settings
Under List settings, you find tools to fine-tune product exposure without changing global settings.
Apply overrides
Overrides are used when you want a specific page or context to behave differently from your default setup. You can override product card images, personalisation, facets and sort orders on a specific page. They allow you to make targeted adjustments without changing your global or market-level configuration.
Use overrides when:
A campaign or landing page needs a different set of facets or sorting
You want to highlight specific filters or product attributes for a particular page
You have temporary or seasonal needs that shouldn’t affect the rest of the site
Overrides are best used for exceptions, not the standard setup. Start with a strong default configuration, and use overrides only where you need more control for a specific purpose.
Enrich products with temporary keywords
Keywords added to a Primary List are applied to all products within that list. This means the products are enriched with those keywords and can be returned when customers search for matching terms. Elevate matches the keyword and then applies its relevance logic to return only the relevant products from that list.
Use keywords for specific, controlled scenarios, such as
- Campaigns and promotions. Example: “Black Friday”, “Summer Sale”. Makes a curated set of products searchable during a campaign
- Mapping a search phrase to a product set - Connect a search term to a specific selection of products
- Alternative terms for a concept. Example: Use both “Christmas” and “Holiday” to return the same product selection. Learn how to work with keywords.
Hide and remove a product list
Use the More option if you want to hide the product list temporarily. Here you can also add an inheriting filter, Manage missing products and permanently delete the list from the page.
Article last updated