Skip to content

Category and Landing Pages

The category and landing pages offers merchandising and overrides of settings of individual pages. Merchandisable pages are listed per market and are automatically populated though requests. Any page that is used will automatically appear, prefilled with applied request settings, when using the API.


App design and features are subject to change without notice. Screenshots, including simulated data visible, are for illustrative purposes only.

Page list view

Pages can be edited and deleted in this view. Changes to page settings can be reset and restored to its previous version. If another user is currently editing a page selected for editing by the current user, a dialogue will allow the current user to either cancel their action or override the other user's edits.

Screenshot of Pages - Category and Landing Page overview tab

Preview and publish pages

Pages can be previewed when settings or lists have changed from the last saved version of the page. Changed pages are indicated in the interface by an orange dot icon next to page that has been changed. When previewing a page, eSales will assume that the page is in preview mode until it the page is exited or the browser is restarted.

To preview a page, a preview URL is required. It is recommended to set a preview base URL for category and landing pages in the Configuration tab of the Admin app. It is recommended to always preview changes before publishing. Unpublished changes can be reverted, restoring the state to the currently published version of a page.

Screenshot of Category and Landing Page - Preview and publish

Edit multiple pages

It is possible to select multiple pages and edit them at the same time. The product list settings can be edited and new lists with a common product selection, such as a recommendation list, can be added. Product selections can not be altered when editing multiple pages.

Page merchandising

A page has a maximum of one primary product list and can have additional (optional) recommendation lists. Lists can be added, removed, and hidden.

Screenshot of Category and Landing Page - Page overview

Page settings

Each page can have its own details and SEO settings. Settings can also be provided via the API, but settings defined and published for a page in the interface will have precedence over any provided settings.

Setting Description
Document name The name of the document as shown in a web browser, i.e. the HTML <title>-tag.
Page Main title The main heading of the page, i.e. the HTML <h1>-tag.
Preamble text The preamble text of the page.
<META> Description The page description that is placed in the HTML <meta>-tag of the document.
Canonical link The full link of a representative page for this content when the current page is a duplicate of another.

Screenshot of Category and Landing Page - Page settings

List settings

A list is primarily defined by its type. There are two types of lists, a primary product list and a recommendation list. All lists have their own product selection and products within all recommendation lists on a page are automatically de-duplicated.

It is possible to override the default product list settings for each list on a page. For more information the different default settings available, see Settings. For recommendation lists, additional settings, such as which ranking algorithm that is used for the recommendation, can be overridden. Pages with overridden settings are denoted with an icon next to the page path in the list of pages.

When creating a product list, additional relevant keywords can be added to increase findability.

Screenshot of Category and Landing Page - Product list settings

Product selection

Products used in a list can be either handpicked or included (or excluded) by rules. For more information, see Product Selection.

Screenshot of Category and Landing Page - Product selection

Product pinning

Products can be pinned, i.e. have a permanent position, in both a primary product list and in a recommendation list. This is useful when for example there is a need to highlight a collection in a product list, or to show a specific set of products on a start page.

Pinned products are always first in a list and pinning is only applied when using Relevance as a sort order in a primary product list, and when the pinned products are included by the active facets and/or filters of the list. Pinning supersedes product promotions and demotions. Pinned products are always first in a recommendation list, no matter what ranking is used.

A pinned product is indicated in the interface by a pin icon in the top right-hand corner of the product image. The position of a pinned product can be changed by dragging the product in the interface. Up to 100 products can be pinned within a list and pinned products are not affected by other rules and settings, such as out of stock settings.

Screenshot of Category and Landing Page - Product pinning


As pages are automatically populated through requests, no further integration than ensuring that the page and the listings on the page are populated by eSales queries. It is important to ensure that the page ID requirements are fulfilled at the request time.

Generating pages through back-office

If it is desirable to work with pages that are not yet live, queries can simply be made emulating the site request from a back-office. E.g. perform a Landing Page request of the desired page with proper filters and ensure to set the query parameter notify to false.

Note that there is a time limit on how often automatically generated pages can change. The first time a page is requested, settings are pre-populated instantly. After that there is a 2 hour limit until further changes propagate from external requests. All merchandising actions are however instant, and the time limit is only relevant for unpublished pages, as published changes always overrides pre-filled options.

Last update: June 22, 2021

This online publication is intellectual property of Apptus Technologies. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Apptus Technologies nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Apptus Technologies essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.