Working with Primary lists in Pages

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. It 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

1. Go to Experience > Pages > Category and Landing pages.
2. From the list, open the relevant category or landing page by selecting its row.
3. Select Add content.

4. In the dropdown, select Primary list and select 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, 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. Select 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 products 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, or to apply rules or merchandising logic to 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, personalization, 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 keywords

Keywords added to a Primary List are applied to all products within that list. 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 — for example, "Black Friday" or "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 — for 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 to temporarily hide the product list. Here you can also add an inheriting filter, manage missing products, and permanently delete the list from the page.

Converting local page facets into a facet template

You can add a facet template from within the Primary List settings editor, without having to navigate to the Facet templates section, and quickly connect it to the edited page.

1. While in the Primary List editor, open the facet settings and select the Convert to template button in the Local page facets section.
2. Enter a template name and confirm to apply it.
3. The set of local facets will disappear and the template will be selected in the dropdown menu.

The Convert to template button is hidden on clusters without facet templates enabled, and for users without permission to manage facet templates.

The Convert to template button is disabled when a template is already selected or when there are no local facets on the page.