Skip to content

Navigation Panels

The pre-defined navigation panels all display products and categories based on the parameters and incoming arguments that are sent with a panel query.

For mandatory arguments for all panels including request URL format, see Panel Query.

Category breadcrumb panel

The result of a query to this panel is a list of all parent categories of the category in the selected_category argument. The result is returned with the topmost category under the root first and ending with the category in the selected_category argument.

Panel arguments

Name Type Description Example
presentation_attributes
Guide
string A comma-separated list of the attributes in the category data to present. Default presentation attributes are used if omitted in the query. image_url,link
selected_category category The tree and category key of the selected category on the format: <tree name>:'<category key>'. Returns an empty result if omitted in the query. category:'Ladies'

Example panel content

The following example will use the panel argument selected_category:'alternative_rock' to return the category breadcrumb.

JSON
{
   "resultType": "categoryList",
      "categoryList": [
      {
         "key": "music",
         "ticket": "L2NhdGVnb3J5LWluZm9ybWF0aW9uOyM7Y2F0ZWdvcnk7Y2F0ZWdvcnlfdWs7QzE7Iw",
         "parent": "root",
         "tree": "category",
         "display_name": "Music"
      },
      {
         "key": "rock",
         "ticket": "L2NhdGVnb3J5LWluZ0ZWdvcnk7Y2F0ZWdvcnlfdWs7QzE7Iwm9ybWF0aW9uOyM7Y2F",
         "parent": "music",
         "tree": "category",
         "display_name": "Rock"
      },
      {
         "key": "alternative_rock",
         "ticket": "L2NhdGVnb3J5LWluZ0ZWdvcnk7QzE7Iwm9ybWF0aW9uOyM7Y2F7Y2F0ZWdvcnlfdWs",
         "parent": "rock",
         "tree": "category",
         "display_name": "Alternative Rock"  
      },
   ]
}

Category information panel

The result of a query to this panel is a list of categories specified in the categories argument. The sort order of the list is the same as specified in the categories argument.

Categories in the result can be from different category trees. Categories included in the categories argument that are not found in the data set will not be listed.

Sub-categories of a category in the categories argument will not be returned in the result. To return sub-categories the Category overview panel may be used.

Panel arguments

Name Type Description Example
categories string A comma-separated list of tree and category key on the form {tree 1}:'{category key 1}',{tree 2}:'{category key 2}',.... Will return an empty result if omitted in the query. category_uk:'C1',category_se'C1'
presentation_attributes
Guide
string A comma-separated list of the attributes in the category data to present. Default presentation attributes are used if omitted in the query. link

Example panel content

The following example will use the panel argument categories:category_uk:'C1',category_se:'C1' to return category information.

JSON
{
   "resultType": "categoryList",
      "categoryList": [
      {
         "key": "C1",
         "ticket": "L2NhdGVnb3J5LWluZm9ybWF0aW9uOyM7Y2F0ZWdvcnk7Y2F0ZWdvcnlfdWs7QzE7Iw",
         "parent": "root",
         "tree": "category_uk"
         "display_name": "Music",
         "attributes": {
            "image_url": "images/classical.jpg"
         }
      },
      {
         "key": "C1",
         "ticket": "L2NhdGVnb3J5LWluZ0ZWdvcnk7Y2F0ZWdvcnlfdWs7QzE7Iwm9ybWF0aW9uOyM7Y2F",
         "parent": "root",
         "tree": "category_se"
         "display_name": "Musik",
         "attributes": {
            "image_url": "images/music.jpg"
         }
      }
   ]
}

Category navigation panel

The result of a query to this panel is a category navigation tree that is expanded according to the selected_category argument. The argument root_category must be included in a query to this panel.

The result tree is represented as a category object for the given root category with sub-categories. The category object follows the following rules:

  1. The selected_category and its parent categories (up to, and including, the root_category) will be selected.
  2. All selected categories will have all of their sub-categories included in the result.
  3. Categories that are not selected will not have any sub-categories in the result.

Each category in the result has an aggregated product count of all its own products including all the products in its sub-categories. The set of products and variants that should be counted can be limited with the use of arguments for filter, facets, and search_phrase.

Categories with product count of 0 are included in the result.

The argument root_category must be included in a query to this panel.

Panel arguments

Name Type Description Example
category_filter filter An expression defining the categories to include. The categories from the root_category and selected_category argument are always included. If the filter excludes a category, its sub-categories are also excluded. Defaults to UNIVERSE if omitted in the query. archive:true
facets facets A pipe-separated list of selected facet values. Used to limit the set of products and variants to use for the product count. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression defining the product and variant set to consider. Used to limit the set of products and variants to use for the product count. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
include_empty_categories boolean A boolean that can be set to false to remove all categories with a product count of zero. The filter argument limits the set of products and variants to use for the product count. Defaults to true if omitted in the query. false
locale string The locale of the sorting when the sorting is made by value. Value sorting will be made in ASCII order. sv_SE
presentation_attributes
Guide
string A comma-separated list of the attributes in the category data to present. Default presentation attributes are used if omitted in the query. image_url,link
root_category category A tree and category key on the format: <tree>:'<category key>'. This category will be the root of the category tree in the result.
Required argument.
category:'Ladies'
search_attributes
Guide
string A comma-separated list of which configured search attributes to search for the search phrase in. A typed format is also available to enable searching in category attributes. Used to limit the set of products and variants to use for the product count. Throws an exception if search_phrase was provided but search_attributes is omitted in the query. product_name,brand
search_phrase string A search phrase to search for in the category data. Search will only be performed in the listed search_attributes. Used to limit the set of products and variants to use for the product count. Selection will not be based on a search if omitted in the query. red dress
selected_category category The tree and category key of the selected category on the format: <tree name>:'<category key>'. Must be a descendant to the root_category or the root_category itself. Defaults to the value of root_category if omitted in the query. category:'Ladies'
sort_by category_order Specifies in which order the sub-categories to each category should be sorted. Secondary orders can be given using a comma-separated list. Can be one or more of relevance, product_count, display_name, and key. Relevance currently ranks categories with high total product sales first. Defaults to relevance if omitted in the query. relevance,display_name

Example panel content

The following example will use the panel arguments sort_by:relevance, root_category:category:'music', and selected_category:category:'music/jazz' to return category navigation.

JSON
{
   "resultType": "categoryTree",
   "categoryTree": {
          "subcategories": [{
              "subcategories": [],
              "selected": false,
              "key": "movie",
              "ticket": "Oy9jYXRlZ29yeS1wYWdlL2xlZnQtY29sdW1uL2NhdGVnb3J5LW5hdmlnYXRpb247IztjYXRlZ29yeTtjYXRlZ29yeTttb3ZpZTsjOyM7Izs",
              "parentKey": "root",
              "displayName": "Movie",
              "productCount": 1000,
              "attributes": {             
              }
          },
          {
              "subcategories": [
              {
                  "subcategories": [],
                  "selected": false,
                  "key": "music/pop-rock",
                  "ticket": "Oy9jYXRlZ29yeS1wYWdlL2xlZnQtY29sdW1uL2NhdGVnb3J5LW5hdmlnYXRpb247IztjYXRlZ29yeTtjYXRlZ29yeTttdXNpYy9wb3Atcm9jazsjOyM7Izs",
                  "parentKey": "music",
                  "displayName": "Pop Rock",
                  "productCount": 50,
                  "attributes": {
                  }
              },
              {
                  "subcategories": [],
                  "selected": false,
                  "key": "music/hip-hop",
                  "ticket": "Oy9jYXRlZ29yeS1wYWdlL2xlZnQtY29sdW1uL2NhdGVnb3J5LW5hdmlnYXRpb247IztjYXRlZ29yeTtjYXRlZ29yeTttdXNpYy9oaXAtaG9wOyM7IzsjOw",
                  "parentKey": "music",
                  "displayName": "Hip Hop",
                  "productCount": 30,
                  "attributes": {
                  }
              },
              {
                  "subcategories": [],
                  "selected": true,
                  "key": "music/jazz",
                  "ticket": "Oy9jYXRlZ29yeS1wYWdlL2xlZnQtY29sdW1uL2NhdGVnb3J5LW5hdmlnYXRpb247IztjYXRlZ29yeTtjYXRlZ29yeTttdXNpYy9qYXp6OyM7IzsjOw",
                  "parentKey": "music",
                  "displayName": "Jazz",
                  "productCount": 30,
                  "attributes": {
                  }
              }],
              "selected": true,
              "key": "music",
              "ticket": "Oy9jYXRlZ29yeS1wYWdlL2xlZnQtY29sdW1uL2NhdGVnb3J5LW5hdmlnYXRpb247IztjYXRlZ29yeTtjYXRlZ29yeTttdXNpYzsjOyM7Izs",
              "parentKey": "root",
              "displayName": "Music",
              "productCount": 110,
              "attributes": {
              }
          },
          {
              "subcategories": [],
              "selected": false,
              "key": "book",
              "ticket": "Oy9jYXRlZ29yeS1wYWdlL2xlZnQtY29sdW1uL2NhdGVnb3J5LW5hdmlnYXRpb247IztjYXRlZ29yeTtjYXRlZ29yeTtib29rOyM7IzsjOw",
              "parentKey": "root",
              "displayName": "Book",
              "productCount": 200,
              "attributes": {
              }
          }],
          "selected": true,
          "key": "root",
          "ticket": "Oy9jYXRlZ29yeS1wYWdlL2xlZnQtY29sdW1uL2NhdGVnb3J5LW5hdmlnYXRpb247IztjYXRlZ29yeTtjYXRlZ29yeTtyb290OyM7IzsjOw",
          "productCount": 1310,
          "attributes": {
          }
      }
}

Category overview panel

The result of a query to this panel is a category tree starting from a given root category. The result tree is represented as a category object for the given root category with sub-categories. The number of levels of sub-categories to be included in the result can be controlled wih the depth argument.

Each category in the result has an aggregated product count of all its own products including all the products in its sub-categories. The set of products and variants that should be counted can be limited with the use of arguments for filter, facets, and search_phrase.

Categories with product count of 0 are included in the result.

The argument root_category must be included in a query to this panel.

Panel arguments

Name Type Description Example
category_filter filter An expression defining the categories to include. The categories from the root_category and selected_category argument are always included. If the filter excludes a category, its sub-categories are also excluded. Defaults to UNIVERSE if omitted in the query. archive:true
depth int The number of sub-category levels included in the result. 0 will return only the root category. 1 will return one level of sub-categories, etc. Defaults to -1 (includes the full tree) if omitted in the query. 2
facets facets A pipe-separated list of selected facet values. Used to limit the set of products and variants to use for the product count. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression defining the product and variant set to consider. Used to limit the set of products and variants to use for the product count. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
include_empty_categories boolean A boolean that can be set to false to remove all categories with a product count of zero. The filter argument limits the set of products and variants to use for the product count. Defaults to true if omitted in the query. false
locale string The locale of the sorting when the sorting is made by value. Value sorting will be made in ASCII order. sv_SE
presentation_attributes
Guide
string A comma-separated list of the attributes in the category data to present. Default presentation attributes are used if omitted in the query. image_url,link
root_category category A tree and category key on the format: <tree>:'<category key>'. This category will be the root of the category tree in the result.
Required argument.
category:'Ladies'
search_attributes
Guide
string A comma-separated list of which configured search attributes to search for the search phrase in. A typed format is also available to enable searching in category attributes. Used to limit the set of products and variants to use for the product count. Throws an exception if search_phrase was provided but search_attributes is omitted in the query. product_name,brand
search_phrase string A search phrase to search for in the category data. Search will only be performed in the listed search_attributes. Used to limit the set of products and variants to use for the product count. Selection will not be based on a search if omitted in the query. red dress
selected_category category The tree and category key of the selected category on the format: <tree name>:'<category key>'. Must be a descendant to the root_category or the root_category itself. Defaults to the value of root_category if omitted in the query. category:'Ladies'
sort_by category_order Specifies in which order the sub-categories to each category should be sorted. Secondary orders can be given using a comma-separated list. Can be one or more of relevance, product_count, display_name, and key. Relevance currently ranks categories with high total product sales first. Defaults to relevance if omitted in the query. relevance,display_name

Example panel content

The following example will use the panel arguments sort_by:display_name, root_category:category:'music', and depth:1 to return a category overview.

JSON
{
   "resultType": "categoryTree",
      "categoryTree": {
          "subcategories": [{
              "subcategories": [],
              "selected": false,
              "key": "music/pop-rock",
              "ticket": "Oy9jYXRlZ29yeS1vdmVydmlldzsjO2NhdGVnb3J5O2NhdGVnb3J5O211c2ljL3BvcC1yb2NrOyM7IzsjOw",
              "parentKey": "music",
              "displayName": "Pop Rock",
              "productCount": 720,
              "attributes": {
                  "department": "music"
              }
          },
          {
              "subcategories": [],
              "selected": false,
              "key": "music/hip-hop",
              "ticket": "Oy9jYXRlZ29yeS1vdmVydmlldzsjO2NhdGVnb3J5O2NhdGVnb3J5O211c2ljL2hpcC1ob3A7IzsjOyM7",
              "parentKey": "music",
              "displayName": "Hip Hop",
              "productCount": 30,
              "attributes": {
                  "department": "music"
              }
          },
          {
              "subcategories": [],
              "selected": false,
              "key": "music/jazz",
              "ticket": "Oy9jYXRlZ29yeS1vdmVydmlldzsjO2NhdGVnb3J5O2NhdGVnb3J5O211c2ljL2pheno7IzsjOyM7",
              "parentKey": "music",
              "displayName": "Jazz",
              "productCount": 35,
              "attributes": {
                  "department": "music"
              }
          }],
          "selected": false,
          "key": "music",
          "ticket": "Oy9jYXRlZ29yeS1vdmVydmlldzsjO2NhdGVnb3J5O2NhdGVnb3J5O211c2ljOyM7IzsjOw",
          "parentKey": "root",
          "displayName": "Music",
          "productCount": 785,
          "attributes": {
          }
      }
}

Facets panel

The result of a query to this panel is a list of facet results, one for each attribute provided in the facets_attributes argument or less if max_facets are used and/or no facets are found for one or more of the facet attributes. A facet result is either a range or values. Each attribute must be configured before use.

Panel arguments

Name Type Description Example
facet_attributes string A comma-separated list of facet configured filter attributes to retrieve facets from. Returns an empty result if omitted in the query. color,size
facet_order facet_order Specifies in which order the facet results should be sorted. The supported values are relevance and facet_attributes. Defaults to facet_attributes if omitted in the query. relevance
facets facets A pipe-separated list of selected facet values. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression defining the product and variant set to find facet values in. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true' AND price:[200, 300]'
locale string The locale of the sorting when the sorting is made by value. Only relevant if any of the facet_attributes are sorted by a String attribute. Value sorting will be made in ASCII order if omitted in the query. sv_SE
max_facets int A number specifying how many different facet results that should be returned. A result for every attribute in the facet_attributes argument will be returned if omitted in the query. 3
search_attributes
Guide
string A comma-separated list of which configured search attributes to search for the search phrase in. Used to limit the product and variant set from where values are selected and should be provided if a search_phrase is given. Throws an exception if search_phrase was provided but search_attributes is omitted in the query. product_name,brand
search_phrase string A search phrase to search for in the product data. Search will only be performed in the listed search_attributes. Used to limit the product and variant set from where values are selected. Value selection will not be based on a search if omitted in the querty. red dress
selected_category category A selected category on the form: <tree name>:'<category key>'. Only products from this category and its sub-categories will be included in the result. Products from all categories are considered if omitted in the query. category:'Ladies'

Example panel content

The following example will use the panel arguments facet_attribute: price,color to return facets.

JSON
{
   "resultType": "facetList",
      "facetList": [{
              "attribute": "price",
              "isRange": true,
              "range": {
                  "min": "100",
                  "max": "1000",
                  "minSelected": "100",
                  "maxSelected": "1000"
              }
          },
          {
              "attribute": "color",
              "isRange": false,
              "values": [{
                  "text": "red",
                  "ticket": "-",
                  "count": 2,
                  "selected": false
              },
              {
                  "text": "blue",
                  "ticket": "-",
                  "count": 1,
                  "selected": false
              },
              {
                  "text": "green",
                  "ticket": "-",
                  "count": 1,
                  "selected": false
              }]
          }
      ]
}

Product breadcrumb panel

The result of a query to this panel is a list of all parent categories of the product in the product_key argument. As a product can be part of more than one category in the same tree, eSales will use session click data to determine what path the visitor has taken. The result is returned with the topmost category under the root first and ending with the category as determined by eSales.

If no relevant categories have been found in the session click data, the breadcrumb will default to the first category defined in the product attribute during the import of products. This default method enables the setting of main category as a fallback. This is useful when a visitor enters a product page directly from an external site.

The arguments category_tree and product_key must be included in a query to this panel.

Panel arguments

Name Type Description Example
category_tree string The category tree to show the breadcrumb from.
Required argument.
category
presentation_attributes
Guide
string A comma-separated list of the attributes in the category data to present. Default presentation attributes are used if omitted in the query. link
product_key string The product to show the breadcrumb for.
Required argument.
P1

Example panel content

The following example will use the panel arguments category_tree:category, and product_key:P1 to return the product breadcrumb.

JSON
{
   "resultType": "categoryList",
      "categoryList": [
      {
         "key": "music",
         "ticket": "L2NhdGVnb3J5LWluZm9ybWF0aW9uOyM7Y2F0ZWdvcnk7Y2F0ZWdvcnlfdWs7QzE7Iw",
         "parent": "root",
         "tree": "category",
         "display_name": "Music"
      },
      {
         "key": "rock",
         "ticket": "L2NhdGVnb3J5LWluZ0ZWdvcnk7Y2F0ZWdvcnlfdWs7QzE7Iwm9ybWF0aW9uOyM7Y2F",
         "parent": "music",
         "tree": "category",
         "display_name": "Rock"
      },
      {
         "key": "alternative_rock",
         "ticket": "L2NhdGVnb3J5LWluZ0ZWdvcnk7QzE7Iwm9ybWF0aW9uOyM7Y2F7Y2F0ZWdvcnlfdWs",
         "parent": "rock",
         "tree": "category",
         "display_name": "Alternative Rock"  
      },
   ]
}

Product count panel

The result of a query to this panel is the number of products in a search result given the specified search phrase. Variant matches for a certain product will count as a product match. Even if several variants within a product matches, the product is only counted once.

The result can be filtered o only include particular types of products anv variants. A search with the added search_phrase argument will only be performed in the provided search_attributes for the filtered data set.

The result will be approximated if the number of products exceeds 10 000.

Panel arguments

Name Type Description Example
facets facets A pipe-separated list of selected facet values. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression defining the product and variant set to find search hits in. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
search_attributes
Guide
string A comma-separated list of which configured search attributes to search for the search phrase in. A typed format is also available to enable searching in category attributes. Will return empty result if search_phrase was provided. name,brand
search_phrase string The search phrase to search for in the product data. Search will only be performed in the listed search_attributes. Selection and ranking won't be based on search phrase if omitted in the query. red dress
selected_category category A selected category on the form: <tree name>:'<category key>'. Only products from this category and its sub-categories will be included in the result. Products from all categories are considered if omitted in the query. category:'Ladies'

Example panel content

The following example will use the panel arguments filter:category:'music', search_attributes:artists,title, and search_phrase:michael to return search data.

JSON
{
   "resultType": "count",
   "count": 31
}

Product list panel

Risk of incorrect usage

The product list panel should be used for static product lists, such as start page product listing or category product listing. These product listings are not triggered by an explicit search performed by a visitor.

A static product listing may be related to a search phrase, but if the product listing is triggered by an explicit search performed by a visitor, the Search hits panel must be used.

The result of a query to this panel is list of products with variants. Additional arguments can be supplied to filter and order the result list and more.

The result is a list of product elements, each specifying all presentation attributes and the list rank of that product. Each product contains all its variants that match the filter ranked by sales.

The arguments window_first and window_last must be included in a query to this panel.

Panel arguments

Name Type Description Example
facets facets A pipe-separated list of selected facet values. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression defining the product and variant set. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
locale string The locale of the sorting when the sorting is made by value. Value sorting will be made in Unicode order if omitted in the query. sv_SE
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Default presentation attributes are used if omitted in the query. name,brand,image_url
search_attributes
Guide
string A comma-separated list of which configured search attributes to search for the search phrase in. A typed format is also available to enable searching in category attributes. Returns empty result if search_phrase was provided but search_attributes is omitted in the query. name,brand
search_phrase string An optional search phrase to search for in the product data. Search will only be performed in the listed search_attributes. Selection and ranking won't be based on search phrase if omitted in the query. red dress
selected_category category A selected category on the form: <tree name>:'<category key>'. Only products from this category and its sub-categories will be included in the result. Products from all categories are considered if omitted in the query. category:'Ladies'
sort_by
Guide
search_order Specifies in which order the products and its variants should be sorted. Secondary orders can be given using a comma-separated list. Defaults to relevance if omitted in the query. price asc
variants_per_product int The maximum number of variants per product to include in the result. No maximum limit. 10
window_first int The first position in the list to be presented. Products before this position, according to the sorting, are not present in the result. The position of the first product in the list is 1.
Required argument.
1
window_last int The last position in the list to be presented. Products after this position, according to the sorting, are not present in the result. The following bounds apply: 1 ≤ window_firstwindow_last ≤ 10 000.
Required argument.
10

Example panel content

The following example will use the panel arguments search_attributes:artists,title, search_phrase:madonna, window_first:1, and window_last:3 to return a product list.

JSON
{
   "resultType": "products",
   "products": [{
      "key": "P103471",
      "ticket": "Oy9wcm9kdWN0LWxpc3Q7Iztwcm9kdWN0X2tleTtQMTAzNDcxOyM7T0JKRUNUSVZFJDtOT05FOk5PTkU7NTE7",
      "variants": [{
          "key": "V103471-1",
          "ticket": "Oy9wcm9kdWN0LWxpc3Q7Iztwcm9kdWN0X2tleTtQMTAzNDcxO1YxMDM0NzEtMTtPQkpFQ1RJVkUkO05PTkU6Tk9ORTs1MTs=",
          "attributes": {
              "custom_attribute": "value1",
              "variant_key": "V103471-1"
          }
      }, 
      {
          "key": "V103471-2",
          "ticket": "Oy9wcm9kdWN0LWxpc3Q7Iztwcm9kdWN0X2tleTtQMTAzNDcxO1YxMDM0NzEtMjtPQkpFQ1RJVkUkO05PTkU6Tk9ORTs1MTs=",
          "attributes": {
              "custom_attribute": "value2",
              "variant_key": "V103471-2"
          }
      }],
      "attributes": {
          "artists": "Madonna",
          "product_key": "P103471",
          "rank": "1",
          "relevance": "1.0",
          "custom_attribute": "value",
          "title": "True Blue (Remastered)"
      }
  },
  {
      "key": "P32950",
      "ticket": "Oy9wcm9kdWN0LWxpc3Q7Iztwcm9kdWN0X2tleTtQMzI5NTA7IztPQkpFQ1RJVkUkO05PTkU6Tk9ORTs1MTs",
      "variants": [],
      "attributes": {
          "artists": "Madonna",
          "product_key": "P32950",
          "rank": "2",
          "relevance": "0.5",
          "custom_attribute": "value",
          "title": "Ray Of Light"
      }
  },
  {
      "key": "P5111",
      "ticket": "Oy9wcm9kdWN0LWxpc3Q7Iztwcm9kdWN0X2tleTtQNTExMTsjO09CSkVDVElWRSQ7Tk9ORTpOT05FOzUxOw",
      "variants": [],
      "attributes": {
          "artists": "Madonna",
          "product_key": "P5111",
          "rank": "3",
          "relevance": "0.3333333333333333",
          "custom_attribute": "value",
          "title": "Like A Prayer"
      }
  }]
}

Product list with count zone

This panel is a zone containing instances of Product list and Product count panels as sub-panels. Arguments to this panel are a combination of the required arguments for the two sub-panels. The result of a query to this panel is a combination of the panel content that can be retrieved by the two result panels.

The arguments window_first and window_last must be included in a query to this panel.

Panel arguments

Name Type Description Example
facets facets A pipe-separated list of selected facet values. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression defining the product and variant set. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
locale string The locale of the sorting when the sorting is made by value. Value sorting will be made in Unicode order if omitted in the query. sv_SE
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Default presentation attributes are used if omitted in the query. name,brand,image_url
search_attributes
Guide
string A comma-separated list of which configured search attributes to search for the search phrase in. A typed format is also available to enable searching in category attributes. Returns empty result if search_phrase was provided but search_attributes is omitted in the query. name,brand
search_phrase string An optional search phrase to search for in the product data. Search will only be performed in the listed search_attributes. Selection and ranking won't be based on search phrase if omitted in the query. red dress
selected_category category A selected category on the form: <tree name>:'<category key>'. Only products from this category and its sub-categories will be included in the result. Products from all categories are considered if omitted in the query. category:'Ladies'
sort_by
Guide
search_order Specifies in which order the products and its variants should be sorted. Secondary orders can be given using a comma-separated list. Defaults to relevance if omitted in the query. price asc
variants_per_product int The maximum number of variants per product to include in the result. No maximum limit. 10
window_first int The first position in the list to be presented. Products before this position, according to the sorting, are not present in the result. The position of the first product in the list is 1.
Required argument.
1
window_last int The last position in the list to be presented. Products after this position, according to the sorting, are not present in the result. The following bounds apply: 1 ≤ window_firstwindow_last ≤ 10 000.
Required argument.
10

Top searches panel

The result of a query to this panel is a list of the most popular search phrases. The result can be filtered to only include search phrases that is associated with particular types of products and variants. Only phrases that has been used in ten sessions or more will be considered.

A search phrase is regarded as used when it has been confirmed a by a visitor. A specific search phrase can only be confirmed once per visitor session. The confirmation is performed when the visitor interacts with a result in the Search hits panel through click, adding to cart, or purchase.

The arguments window_first and window_last must be included in a query to this panel.

Panel arguments

Name Type Description Example
facets facets A pipe-separated list of selected facet values. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression limiting the considered product and variant set. color:'red' OR color:'blue' AND in_stock:'true'
search_attributes
Guide
string A comma-separated list of which configured search attributes to search for the search phrase in. A typed format is also available to enable searching in category attributes. Returns empty result if search_phrase was provided but search_attributes is omitted in the query. name,brand
selected_category category A selected category on the form: <tree name>:'<category key>'. Only products from this category and its sub-categories will be included in the result. Products from all categories are considered if omitted in the query. category:'Ladies'
window_first int The first position in the list to be presented. Products before this position, according to the sorting, are not present in the result. The position of the first product in the list is 1.
Required argument.
1
window_last int The last position in the list to be presented. Products after this position, according to the sorting, are not present in the result. The following bounds apply: 1 ≤ window_firstwindow_last ≤ 10 000.
Required argument.
10

Example panel content

The following example will use the panel arguments filter:category:'movies', search_attributes:title,actors, window_first:1, and window_last:3 to return top searches.

JSON
{
   "resultType": "phrases",
   "phrases": [{
        "text": "twilight",
        "ticket": "L3N0YXJ0LXBhZ2UvbGVmdC1jb2x1bW4vcmVjZW50LXNlYXJjaGVzO3RleHQ7",
        "rank": "1",
        "relevance": "0.0"
      },
      {
        "text": "avatar",
        "ticket": "L3N0YXJ0LXBhZ2UvbGVmdC1jb2x1bW4vcmVjZW50LXNlYXJjaGVzO3RleHQ7Mw",
        "rank": "2",
        "relevance": "0.0"
      },
      {
        "text": "ncis",
        "ticket": "L3N0YXJ0LXBhZ2UvbGVmdC1jb2x1bW4vcmVjZW50LXNlYXJjaGVzO3RleHQ7Mg",
        "rank": "3",
        "relevance": "0.0"
      }
    ]
}

Top sellers panel

The result of a query to this panel is a list of products that are sold the most. If variants are used, the products will be ranked by their top selling variant. Additional arguments can be supplied to filter the result list and more.

The result is a list of product elements, each specifying all presentation attributes and the list rank of that product. Each product contains all its variants that match the filter ranked by sales.

The arguments window_first and window_last must be included in a query to this panel.

Panel arguments

Name Type Description Example
facets facets A pipe-separated list of selected facet values. Ignored if omitted in the query. color:red|blue,size:6
filter
Guide
filter An expression limiting the considered product and variant set. color:'red' OR color:'blue' AND in_stock:'true'
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Default presentation attributes are used if omitted in the query. name,brand
selected_category category A selected category on the form: <tree name>:'<category key>'. Only products from this category and its sub-categories will be included in the result. Products from all categories are considered if omitted in the query. category:'Ladies'
variants_per_product int The maximum number of variants per product to include in the result. No maximum limit . 10
window_first int The first position in the list to be presented. Products before this position, according to the sorting, are not present in the result. The position of the first product in the list is 1.
Required argument.
1
window_last int The last position in the list to be presented. Products after this position, according to the sorting, are not present in the result. The following bounds apply: 1 ≤ window_firstwindow_last ≤ 10 000.
Required argument.
10

Example panel content

The following example will use the panel arguments filter: category:'books-for-children', window_first: 1, and window_last: 3 to return top sellers.

JSON
{
  "resultType": "products",
  "products": [
  {
      "key": "P1",
      "ticket": "Oy90b3Atc2VsbGVyczsjO3Byb2R1Y3Rfa2V5O1AxOyM7T0JKRUNUSVZFJDtOT05FOk5PTkU7NTE7",
      "variants": [{
              "key": "V1-1",
              "ticket": "Oy90b3Atc2VsbGVyczsjO3Byb2R1Y3Rfa2V5O1AxO1YxLTE7T0JKRUNUSVZFJDtOT05FOk5PTkU7NTE7=",
              "attributes": {
                  "edition": "Kindle",
                  "variant_key": "V1-1"
              }
          },
          {
              "key": "V1-2",
              "ticket": "Oy90b3Atc2VsbGVyczsjO3Byb2R1Y3Rfa2V5O1AxO1YxLTI7T0JKRUNUSVZFJDtOT05FOk5PTkU7NTE7=",
              "attributes": {
                  "edition": "Hardcover",
                  "variant_key": "V1-2"
              }
          }
      ],
      "attributes": {
          "product_key": "P1",
          "rank": "1",
          "relevance": "1.0",
          "authors": "J.K. Rowling, Jack Thorne, John Tiffany",
          "title": "Harry Potter and the Cursed Child"
      }
  },
  {
      "key": "P250",
      "ticket": "Oy90b3Atc2VsbGVyczsjO3Byb2R1Y3Rfa2V5O1AyNTA7IztPQkpFQ1RJVkUkO05PTkU6Tk9ORTs1MTs=",
      "variants": [],
      "attributes": {
          "product_key": "P250",
          "rank": "2",
          "relevance": "0.5",
          "authors": "Jeff Kinney",
          "title": "Diary of a Wimpy Kid"
      }
  },
  {
      "key": "P3",
      "ticket": "Oy90b3Atc2VsbGVyczsjO3Byb2R1Y3Rfa2V5O1AzOyM7T0JKRUNUSVZFJDtOT05FOk5PTkU7NTE7",
      "variants": [],
      "attributes": {
          "product_key": "P3",
          "rank": "3",
          "relevance": "0.3333333333333333",
          "authors": "Elena Favilli, Francesca Cavallo",
          "title": "Good Night Stories for Rebel Girls"
      }
  }]
}
×