Skip to content

Working with Search Attributes

The product, ad, and category attributes in eSales can have configured search attributes. Search attributes defines what attributes are usable in panel queries for searching. Attributes that do not have search attributes configured cannot be searched.

Panels used for search accepts the argument search_attributes. This argument defines which search attributes that will be searched by eSales.

Simple format

The standard format for search attributes are comma-separated lists.

Example attributes Description
title Search will be performed in the title search attribute of products.
title,author Search will be performed in the title and author search attributes of products.

Typed format

The typed format allows for searching in the attributes of a product's categories. The attributes to must be specified for each entity type. The different entity types are separated by a comma (,) and each entity type is specified as type[comma-separated list of attributes].

It is not possible to use both the simple and the typed format in the same argument.

Example attributes Description
product[title,author] Search will be performed in the title and author search attributes of products.
product[title,author],category[display_name] Search will be performed in the title and author search attributes of products, and in the display_name search attribute of their categories.
category[display_name] Search will be performed in the display_name search attribute of categories.


Search phrases used in eSales are always treated as text. This means that no specific refinement can be set for search attributes. However, the text in the product attributes is tokenised (split into words) with special rules for:

  • Words combining letters and digits such as model designations, e.g. iPhone 8 256GB
  • Words combined with hyphens, e.g. blue-green
  • Words with camel case, e.g. MasterCard

East asian languages

East asian languages requires special rules to split text. The following locales are supported in eSales:

th_TH, zh_CN, zh_HK, zh_TW, ja_JP, ko_KR, en_HK, en_CN, en_TW, en_KR, en_JP

The resulting set of words are normalised by making the text lower case and removing the following special characters:


An extended version of the Snowball stemming algorithm is then used on the set of words. Stemming is a process to produce the stem of a word. It is performed to enable eSales to match queries to conjugations and inflections of the words in the set.

Stemming availability

Stemming of data and queries is available for locales with the following language components:

da, de, en, es, fi, fr, it, nl, no, pt, ru, sv