A panel can be described as an area on a page where eSales functionality is used. The main types of panels are result panels and zones. Some panels can be reused on several pages, such as navigation.

Panels are set up in a hierarchy to define the content structure of an e-shop. Requests to panels through the Web API with Panel Queries returns the content based on the panel type, its configuration and what arguments are sent to them.

Panels can only be queried through the Web API when the panel hierarchy for a site has been published. The publishing generates unique paths to the panels and zones based on the panel names. The paths are used for identification with queries and statistics. The name of a panel or zone should reflect its use and position in the site structure.

A panel or zone should not be renamed after its initial publishing. All statistics for panels and zones are connected to their path. As the path is based on the panel and zone name, statistics will be reset when the identifying path is changed.

Result panels

The core type of panel is a result panel. This type of panel can contain items returned from eSales such as a list of products, a did-you-mean suggestion, or a list of faceted product attributes.


An other type of panel are zones. A zone is a container of other panels that are used to build a specific panel structure. This container most often represent a page or a specific part of a page.

Predefined panels

Apptus eSales includes several predefined panels in a panel library. The predefined panels includes functions such as general product listing, auto-complete results, and product recommendations.

Predefined ads panels

Predefined customer panels

Predefined navigation panels

Predefined product panels

Predefined recommendation panels

Predefined search panels


Result panels in a panel hierarchy can accept arguments in addition to any default or required values. Argument values can be defined in a parent zone, in the result panel itself, or left undefined. Arguments that are left undefined at the root of a panel hierarchy must be supplied at the time of the request.

Panel notifications

Each part of an eSales panel (including products and categories) have a unique identifying ticket that can be sent into eSales with notifications in the Web API. The more notifications sent into eSales, the more it will learn from the visitor behaviour and provide better content as a result.

The click and adding-to-cart notification types should be used to notify interactions with following eSales entities.

  • ads
  • categoryList
  • categoryTree
  • completions
  • corrections
  • facetList
  • phrases
  • products