Category pages and generic landing pages are requested through the same end point, called landing-page. This end point caters for any page with faceted product listings, recommendation listings, or a combination of the two. It is suitable for the start page and intermediate category pages, as well as category pages, brand pages, and for example collection pages.
Inclusion of a primary product listing with facets, and which recommendation listings to include is configurable.
A key that uniquely identifies the current visitor. Using UUIDs as keys are recommended.
0b05119e-eeb8-418a-bbfb-defa0dde417e
locale Required
The visitor locale. Must match an available locale identifier on the current market in the data feed.
market Required
The visitor market identifier. Must match the corresponding market identifier in the data feed.
UK
pageReference Required
A reference to the page, either Page ID or the localized path, uniquely identifying this page. For more information about page references, see Page IDs.
/women/shoes/loafers
sessionKey Required
A unique key, identifying the session. Using UUIDs as keys are recommended.
0b05119e-eeb8-418a-bbfb-defa0dde417e
touchpoint Required
The visitor's touchpoint. Supported values: DESKTOP, MOBILE.
DESKTOP
channels
Which channels to use. Valid values are ONLINE and STORE. Multiple values are provided with a pipe, |, as a separator. channels will default to ONLINE|STORE if nothing is provided. If STORE is explicitly provided then stores cannot be empty. Supported values: ONLINE, STORE.
ONLINE|STORE
f.[id]
An example parameter of a value or checkbox attribute. Value attributes can be a | pipe-separated list of strings, while a checkbox attributes only can be true or false. Detailed information is available at Facet selections.
Bosch|Dewalt or true/false
f.[id].max
An example parameter of a range attribute.
1000
f.[id].min
The applied Facet selection in the search result/primary product listing. Each facet attribute is prefixed with f.
0
includeNavigation
Whether or not the response should include a navigation object (including breadcrumbs), i.e. when navigation is handled through Elevate. Defaults to false if omitted.
false
limit
The number of product hits to list. For each product hit in the list, its product group is returned in full to facilitate rendering of colour swatches and more. Defaults to 60 if omitted in the query, the min value is 1 and the max value is 600.
10
notify
A boolean that can be used to disable notifications and behavioural registration for the query.
false
presentCustom
A pipe-separated list of custom attributes or custom typed attributes to include in all listings. Prefix with variant. to request custom variant attributes. Prefix with number. or length. to request custom typed attributes
season|variant.number.item_count|variant.weight
presentPrices
A pipe-separated list of custom price ids to include in all listings. Each id must match a supplied custom price id in the data feed.
VIP|member
priceId
A custom price identifier. Must match supplied custom price identifiers in the data feed.
VIP
q
A search phrase used to further refine the result
green
skip
The number of product groups to skip. Used for pagination, defaults to 0 if omitted in the query. The min value is 0 and the max value is 10000.
10
sort
The applied sort order on the landing page. Only include this after explicit visitor interaction. Defaults to 'RELEVANCE' or overridden default value set in Apps. Supported values: RELEVANCE, NEWEST_FIRST, PRICE_ASCENDING, PRICE_DESCENDING, DISCOUNT, RATING, NAME, LENGTH_INCREASING, LENGTH_DECREASING, WIDTH_INCREASING, WIDTH_DECREASING, HEIGHT_INCREASING, HEIGHT_DECREASING, DEPTH_INCREASING, DEPTH_DECREASING, VOLUME_INCREASING, VOLUME_DECREASING, WEIGHT_INCREASING, WEIGHT_DECREASING, TITLE.
NEWEST_FIRST
stores
Which stores to use. Will impact which stock is displayed and which stock is used for filtering/ranking together with channel. Multiple values are provided with a pipe, |, as a separator. Each store must match a supplied store key in the data feed.
240|100
templateId
The id of a response template to apply to all product lists returned. Templates can be imported via the template API.
template1
viewId
A parameter that is used to show the page in either production or preview mode. Can be production or preview. Defaults to production if omitted in the query. For more information, see App Integration. Supported values: PRODUCTION, PREVIEW.
{"contentLists":[{"id":"content-hits","items":[{"custom":{"tags":[{"id":"78","label":"Guide"},{"id":"223","label":"Jeans"}]},"description":"To wash or not to wash? And how?! Those are questions jeans shoppers are asking.","image":{"alt":"A woman wearing a white t-shirt","caption":"The model is 176 cm tall and is wearing size S","custom":{},"sources":[{"url":"https://cdn.example.com/img/j12_prod.jpg","height":820,"width":420}]},"key":"wash_care","link":"/wash-guide","releaseDate":"2021-10-01T00:00:00Z","ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","title":"How to wash jeans","type":"article"}],"totalHits":10}],"customData":{"preamble":"A carefully curated selection of products...","bannerImage":"/assets/banners/sale_01.jpg"},"navigation":{"breadcrumbs":[{"label":"Women's shoes","path":"womens/shoes/"}],"tree":{"children":[null],"count":5,"customData":{"highlight":"true","viewableFrom":"2010-10-20 00:00:00"},"expandable":true,"iconPath":"/resources/images/navigation/spring_node.jpg","label":"All products","link":"/springselections","path":"/","selected":false,"type":"PAGE_LINK"}},"primaryList":{"facets":[{"id":"size","label":"size","type":"RANGE"}],"productGroups":[{"key":"PRODGROUP060194","products":[{"badges":{"primary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}],"secondary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}]},"brand":"Versace","custom":{},"depth":{"amount":25.0,"unit":"cm"},"description":"Super elastic fit.","height":{"amount":25.0,"unit":"cm"},"imageInfo":{"effect":"NONE","images":[{"alt":"A woman wearing a white t-shirt","caption":"The model is 176 cm tall and is wearing size S","custom":{},"sources":[{"url":"https://cdn.example.com/img/j12_prod.jpg","height":820,"width":420}]}],"thumbnail":"https://cdn.example.com/thumbs/j12_prod.jpg"},"inStock":true,"key":"p1000-101","length":{"amount":25.0,"unit":"cm"},"link":"men/jeans/country-fit-cowboy-jeans","listPrice":{"max":4500.0,"min":190.5},"name":"Romeo","rating":4.5,"remainingVariants":0,"sellingPrice":{"max":4500.0,"min":190.5},"series":"Billy","sponsored":true,"swatch":{"colors":["#FF0000"],"type":"COLORS"},"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","title":"Country Fit Cowboy Jeans","typedCustom":{"json":{},"lengths":{},"numbers":{}},"variants":[{"availability":[{"channel":"STORE","key":"boardwalk","stockNumber":5}],"custom":{},"depth":{"amount":25.0,"unit":"cm"},"height":{"amount":25.0,"unit":"cm"},"inStock":true,"key":"1000-101_RED","label":"XL","length":{"amount":25.0,"unit":"cm"},"link":"women/pants/khaki/101-v3-red","listPrice":15.0,"prices":[{"id":"VIP_EUR","listPrice":12.99,"sellingPrice":9.99}],"sellingPrice":24.0,"stockNumber":5,"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","typedCustom":{"json":{},"lengths":{},"numbers":{}},"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"remaining":2}],"sliceRanges":[{"from":0,"id":null,"to":1}],"sort":{"options":[{"id":"RELEVANCE","label":"Relevance"}],"selected":"RELEVANCE"},"totalHits":0},"published":true,"recommendationLists":[{"id":"PDP-1","label":"The presentation text of the list.","productGroups":[{"key":"PRODGROUP060194","products":[{"badges":{"primary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}],"secondary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}]},"brand":"Versace","custom":{},"depth":{"amount":25.0,"unit":"cm"},"description":"Super elastic fit.","height":{"amount":25.0,"unit":"cm"},"imageInfo":{"effect":"NONE","images":[{"alt":"A woman wearing a white t-shirt","caption":"The model is 176 cm tall and is wearing size S","custom":{},"sources":[{"url":"https://cdn.example.com/img/j12_prod.jpg","height":820,"width":420}]}],"thumbnail":"https://cdn.example.com/thumbs/j12_prod.jpg"},"inStock":true,"key":"p1000-101","length":{"amount":25.0,"unit":"cm"},"link":"men/jeans/country-fit-cowboy-jeans","listPrice":{"max":4500.0,"min":190.5},"name":"Romeo","rating":4.5,"remainingVariants":0,"sellingPrice":{"max":4500.0,"min":190.5},"series":"Billy","sponsored":true,"swatch":{"colors":["#FF0000"],"type":"COLORS"},"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","title":"Country Fit Cowboy Jeans","typedCustom":{"json":{},"lengths":{},"numbers":{}},"variants":[{"availability":[{"channel":"STORE","key":"boardwalk","stockNumber":5}],"custom":{},"depth":{"amount":25.0,"unit":"cm"},"height":{"amount":25.0,"unit":"cm"},"inStock":true,"key":"1000-101_RED","label":"XL","length":{"amount":25.0,"unit":"cm"},"link":"women/pants/khaki/101-v3-red","listPrice":15.0,"prices":[{"id":"VIP_EUR","listPrice":12.99,"sellingPrice":9.99}],"sellingPrice":24.0,"stockNumber":5,"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","typedCustom":{"json":{},"lengths":{},"numbers":{}},"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"remaining":2}],"showMoreLink":"https://example.com/prods/jeans/levis","visible":true,"visualization":"CAROUSEL"}],"seo":{"pageHeading":"OUR LOAFERS"}}
An object with navigation options. Defaults to include: false. Set to include: true to return the navigation object (including breadcrumbs), i.e. when navigation is handled through Elevate.
Category pages and generic landing pages are requested through the same end point, called landing-page. This end point caters for any page with faceted product listings, recommendation listings, or a combination of the two. It is suitable for the start page and intermediate category pages, as well as category pages, brand pages, and for example collection pages. Inclusion of a primary product listing with facets, and which recommendation listings to include is configurable.
A key that uniquely identifies the current visitor. Using UUIDs as keys are recommended.
0b05119e-eeb8-418a-bbfb-defa0dde417e
locale Required
The visitor locale. Must match an available locale identifier on the current market in the data feed.
market Required
The visitor market identifier. Must match the corresponding market identifier in the data feed.
UK
pageReference Required
A reference to the page, either Page ID or the localized path, uniquely identifying this page. For more information about page references, see Page IDs.
/women/shoes/loafers
sessionKey Required
A unique key, identifying the session. Using UUIDs as keys are recommended.
0b05119e-eeb8-418a-bbfb-defa0dde417e
touchpoint Required
The visitor's touchpoint. Supported values: DESKTOP, MOBILE.
DESKTOP
channels
Which channels to use. Valid values are ONLINE and STORE. Multiple values are provided with a pipe, |, as a separator. channels will default to ONLINE|STORE if nothing is provided. If STORE is explicitly provided then stores cannot be empty. Supported values: ONLINE, STORE.
ONLINE|STORE
f.[id]
An example parameter of a value or checkbox attribute. Value attributes can be a | pipe-separated list of strings, while a checkbox attributes only can be true or false. Detailed information is available at Facet selections.
Bosch|Dewalt or true/false
f.[id].max
An example parameter of a range attribute.
1000
f.[id].min
The applied Facet selection in the search result/primary product listing. Each facet attribute is prefixed with f.
0
limit
The number of product hits to list. For each product hit in the list, its product group is returned in full to facilitate rendering of colour swatches and more. Defaults to 60 if omitted in the query, the min value is 1 and the max value is 600.
10
notify
A boolean that can be used to disable notifications and behavioural registration for the query.
false
presentCustom
A pipe-separated list of custom attributes or custom typed attributes to include in all listings. Prefix with variant. to request custom variant attributes. Prefix with number. or length. to request custom typed attributes
season|variant.number.item_count|variant.weight
presentPrices
A pipe-separated list of custom price ids to include in all listings. Each id must match a supplied custom price id in the data feed.
VIP|member
priceId
A custom price identifier. Must match supplied custom price identifiers in the data feed.
VIP
q
A search phrase used to further refine the result
green
skip
The number of product groups to skip. Used for pagination, defaults to 0 if omitted in the query. The min value is 0 and the max value is 10000.
10
sort
The applied sort order on the landing page. Only include this after explicit visitor interaction. Defaults to 'RELEVANCE' or overridden default value set in Apps. Supported values: RELEVANCE, NEWEST_FIRST, PRICE_ASCENDING, PRICE_DESCENDING, DISCOUNT, RATING, NAME, LENGTH_INCREASING, LENGTH_DECREASING, WIDTH_INCREASING, WIDTH_DECREASING, HEIGHT_INCREASING, HEIGHT_DECREASING, DEPTH_INCREASING, DEPTH_DECREASING, VOLUME_INCREASING, VOLUME_DECREASING, WEIGHT_INCREASING, WEIGHT_DECREASING, TITLE.
NEWEST_FIRST
stores
Which stores to use. Will impact which stock is displayed and which stock is used for filtering/ranking together with channel. Multiple values are provided with a pipe, |, as a separator. Each store must match a supplied store key in the data feed.
240|100
templateId
The id of a response template to apply to all product lists returned. Templates can be imported via the template API.
template1
viewId
A parameter that is used to show the page in either production or preview mode. Can be production or preview. Defaults to production if omitted in the query. For more information, see App Integration. Supported values: PRODUCTION, PREVIEW.
A configuration object representing the request to the category or landing page endpoint. An existing page configuration, identified by the supplied page reference or page id, created via the Admin API or Elevate Application takes precedence over a supplied configuration.
{"contentLists":[{"id":"content-hits","items":[{"custom":{"tags":[{"id":"78","label":"Guide"},{"id":"223","label":"Jeans"}]},"description":"To wash or not to wash? And how?! Those are questions jeans shoppers are asking.","image":{"alt":"A woman wearing a white t-shirt","caption":"The model is 176 cm tall and is wearing size S","custom":{},"sources":[{"url":"https://cdn.example.com/img/j12_prod.jpg","height":820,"width":420}]},"key":"wash_care","link":"/wash-guide","releaseDate":"2021-10-01T00:00:00Z","ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","title":"How to wash jeans","type":"article"}],"totalHits":10}],"customData":{"preamble":"A carefully curated selection of products...","bannerImage":"/assets/banners/sale_01.jpg"},"navigation":{"breadcrumbs":[{"label":"Women's shoes","path":"womens/shoes/"}],"tree":{"children":[null],"count":5,"customData":{"highlight":"true","viewableFrom":"2010-10-20 00:00:00"},"expandable":true,"iconPath":"/resources/images/navigation/spring_node.jpg","label":"All products","link":"/springselections","path":"/","selected":false,"type":"PAGE_LINK"}},"primaryList":{"facets":[{"id":"size","label":"size","type":"RANGE"}],"productGroups":[{"key":"PRODGROUP060194","products":[{"badges":{"primary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}],"secondary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}]},"brand":"Versace","custom":{},"depth":{"amount":25.0,"unit":"cm"},"description":"Super elastic fit.","height":{"amount":25.0,"unit":"cm"},"imageInfo":{"effect":"NONE","images":[{"alt":"A woman wearing a white t-shirt","caption":"The model is 176 cm tall and is wearing size S","custom":{},"sources":[{"url":"https://cdn.example.com/img/j12_prod.jpg","height":820,"width":420}]}],"thumbnail":"https://cdn.example.com/thumbs/j12_prod.jpg"},"inStock":true,"key":"p1000-101","length":{"amount":25.0,"unit":"cm"},"link":"men/jeans/country-fit-cowboy-jeans","listPrice":{"max":4500.0,"min":190.5},"name":"Romeo","rating":4.5,"remainingVariants":0,"sellingPrice":{"max":4500.0,"min":190.5},"series":"Billy","sponsored":true,"swatch":{"colors":["#FF0000"],"type":"COLORS"},"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","title":"Country Fit Cowboy Jeans","typedCustom":{"json":{},"lengths":{},"numbers":{}},"variants":[{"availability":[{"channel":"STORE","key":"boardwalk","stockNumber":5}],"custom":{},"depth":{"amount":25.0,"unit":"cm"},"height":{"amount":25.0,"unit":"cm"},"inStock":true,"key":"1000-101_RED","label":"XL","length":{"amount":25.0,"unit":"cm"},"link":"women/pants/khaki/101-v3-red","listPrice":15.0,"prices":[{"id":"VIP_EUR","listPrice":12.99,"sellingPrice":9.99}],"sellingPrice":24.0,"stockNumber":5,"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","typedCustom":{"json":{},"lengths":{},"numbers":{}},"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"remaining":2}],"sliceRanges":[{"from":0,"id":null,"to":1}],"sort":{"options":[{"id":"RELEVANCE","label":"Relevance"}],"selected":"RELEVANCE"},"totalHits":0},"published":true,"recommendationLists":[{"id":"PDP-1","label":"The presentation text of the list.","productGroups":[{"key":"PRODGROUP060194","products":[{"badges":{"primary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}],"secondary":[{"attribute":"is_new","label":"Latest!","theme":"NEW"}]},"brand":"Versace","custom":{},"depth":{"amount":25.0,"unit":"cm"},"description":"Super elastic fit.","height":{"amount":25.0,"unit":"cm"},"imageInfo":{"effect":"NONE","images":[{"alt":"A woman wearing a white t-shirt","caption":"The model is 176 cm tall and is wearing size S","custom":{},"sources":[{"url":"https://cdn.example.com/img/j12_prod.jpg","height":820,"width":420}]}],"thumbnail":"https://cdn.example.com/thumbs/j12_prod.jpg"},"inStock":true,"key":"p1000-101","length":{"amount":25.0,"unit":"cm"},"link":"men/jeans/country-fit-cowboy-jeans","listPrice":{"max":4500.0,"min":190.5},"name":"Romeo","rating":4.5,"remainingVariants":0,"sellingPrice":{"max":4500.0,"min":190.5},"series":"Billy","sponsored":true,"swatch":{"colors":["#FF0000"],"type":"COLORS"},"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","title":"Country Fit Cowboy Jeans","typedCustom":{"json":{},"lengths":{},"numbers":{}},"variants":[{"availability":[{"channel":"STORE","key":"boardwalk","stockNumber":5}],"custom":{},"depth":{"amount":25.0,"unit":"cm"},"height":{"amount":25.0,"unit":"cm"},"inStock":true,"key":"1000-101_RED","label":"XL","length":{"amount":25.0,"unit":"cm"},"link":"women/pants/khaki/101-v3-red","listPrice":15.0,"prices":[{"id":"VIP_EUR","listPrice":12.99,"sellingPrice":9.99}],"sellingPrice":24.0,"stockNumber":5,"ticket":"Oy9mYXNoaW9uL0RFU0tUT1AvQ09OVEVOVF9TRUFSQ0hfUEFHRS9QUklNQVJZX0xJU1Q7Iztjb250ZW50X2tleTtkMDAxOyM7IzsjOyM7","typedCustom":{"json":{},"lengths":{},"numbers":{}},"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"volume":{"amount":25.0,"unit":"cm"},"weight":{"amount":25.0,"unit":"cm"},"width":{"amount":25.0,"unit":"cm"}}],"remaining":2}],"showMoreLink":"https://example.com/prods/jeans/levis","visible":true,"visualization":"CAROUSEL"}],"seo":{"pageHeading":"OUR LOAFERS"}}
An object with navigation options. Defaults to include: false. Set to include: true to return the navigation object (including breadcrumbs), i.e. when navigation is handled through Elevate.
The identifier for the facet value, used by Elevate to determine which facet value has been selected. Should only be used when creating facet query-parameters.
Content filters can be applied to most content listings and are included in the request body for the target listing. Applying a filter will restrict the set of returned content and can only be string value filters e.g. not numeric. Listing multiple attributes to filter on will restrict the content to all conditions (logical AND). When listing values within one attribute, content with any of the listed properties apply (logical OR). In addition, any custom attribute can be used as a value filter, through prefixing the attribute to be filtered with custom., for example custom.season. The following example filters on content having both a specific designer and one or both seasons listed: {"custom.designer": "Langdon","type": "article", "custom.season": ["Winter", "Spring"]} Here is a brief description of the filters available:
Name
Type
Description
content_key
string[]
The key(s) of the content items you wish to filter.
Example: ["a1","d2"]
custom.ATTRIBUTE
string
The custom attribute as the name and then the values you wish to filter on. Note that ATTRIBUTE should be replaced with a custom attribute in the data feed.
Example: "abc123"
type
string[]
The type(s) of the content items you wish to filter.
The object representation of the content list. Content lists are supported by the Search-page, autocomplete and landing-page. To include content lists in a page response, the request body must include a content list configuration.
The interaction effects of the product images. Merchandiser option. Defaults to NONE if there are fewer than two valid images for that product. Supported values: NONE, SWAP, GALLERY.
A list of products, represented as groups containing a main product and its sibling products within its product group. Each element in this list should correspond to its own product card.
A logical expression used by Voyado Elevate 4 to restrict the data set to a Product Selection. The rules can go from easy, such as to only include a product by its key or items that are in stock, to more complex expressions with multiple attributes for products at the same time.
If no rules are provided, the entire data set will be used.
Please note that when used in Landing Pages, the "Handpicked" rule must be the first rule, and must contain a set of product keys as its only condition. At most 100 product keys can be handpicked in a single request, and at most 200 attribute values can be supplied for each attribute.
This feature will most likely be removed in new versions.
A product filter restricting which products that the listing may contain. Supports single values, lists, and (for numerical attributes) ranges. Listing multiple attributes to filter on will restrict the products to all conditions (logical AND). When listing values within one attribute, products with any of the listed properties apply (logical OR). In addition to built-in attributes, it is also possible to filter on custom facets, through prefixing the attribute to be filtered with custom., for example "custom.season": ["Winter", "Spring"]. At most 200 attribute values can be supplied per attribute and at most 100 product keys can be picked at once.
Products in the Product group. The first element corresponds to the main product. The remaining elements are the other products in the group, to be shown as thumbnails or color swatches, etc.
remaining
integer
The number of products within this group not included in the response. E.g. if Elevate has been set to include the first five products in the response and this group has seven, there will be two remaining.
Current rating value. Undefined when ratings are disabled.
Example: 4.5
remainingVariants
integer
The number of variants not included in the response. Only included if the number of variants have been limited through a template. Does not include variants hidden for being out of stock.
A configuration object for the recommendation list request. Most page types support recommendation lists. To include recommendation lists in a page response, the request body must include the recommendation configuration. Be aware that having many lists with complex rules/algorithms on a page may affect response times.
Name
Type
Description
id Required
string
An identifier for the recommendation listing area. Multiple pages using the same template can share identifiers, but one identifier may not appear twice within a page. E.g. all product pages should use the same identifier for their alternative recommendation areas. Min length: 1. Max length: 20. Pattern: ^[A-Za-z0-9_-]*$.
Example: "RECS1"
algorithm
string
The algorithm to apply on the recommendation listing. Defaults to TOP_PRODUCTS. Note that some algorithms may require additional parameters see here for more information. Supported values: TOP_PRODUCTS, PERSONAL, CART, FAVORITES, UPSELL, STYLE_WITH, ALTERNATIVES, NEWEST_PRODUCTS, MORE_FROM_SERIES, RECENTLY_VIEWED, ADD_TO_CART_RECS.
Example: "CART"
label
string
The presentation text of the list. Min length: 1. Max length: 200. Pattern: (?:|.[^s].).
Example: "Recommended for you"
limit
integer
The number of product groups to list. Note: When using algorithm RECENTLY_VIEWED, maximum 20 product groups are returned regardless of max value. Min: 1. Max: 200. Default: 4.
A URL to see a large selection. Undefined if not specified in Elevate Apps. Merchandiser option. Min length: 1. Max length: 1000. Pattern: ^(//|/|https?://).*.
Example: "/holiday/sale"
visualization
string
How the list should be presented. Merchandiser option. Supported values: CAROUSEL, GRID.
Products that match the selected algorithm. Each group contains a main product and its sibling products within its product group. Each group should correspond to one product card.
showMoreLink
string
A URL to see a large selection. Undefined if not specified in eSales Apps. Merchandiser option.
A list of product and/or variant keys depicting the cart content. Must match keys of variants or products in the data feed. Always use the variant key when possible. Defaults to the provided cart parameter for cart-page requests. Min items: 0. Max items: 250.
Example: "v1_1"
productKey
string
The base product for the ALTERNATIVES, STYLE_WITH, and UPSELL recommendation algorithms. Defaults to the provided product key parameter for product-page requests.
Description for the current category, use with: <meta type="description" content="{VALUE}"> Undefined if not configured for the current page. Will be replaced by custom data.
Example: "Exclusive loafers for everyday use"
pageHeading
string
The heading for the page
Example: "OUR LOAFERS"
pageTitle Deprecated
string
Title for the current category, use with: <title>{VALUE}</title> Undefined if not configured for the current page. Will be replaced by custom data.
Example: "Loafers"
preamble Deprecated
string
Preamble text for the current category. Undefined if not configured for the current page. Will be replaced by custom data.
The identifier for the facet value, used by Elevate to determine which facet value has been selected. Should only be used when creating facet query-parameters.
Swatch information is used to generate swatches for different products. The type COLORS is the most common returned type and is accompanied by the actual colours as CSS colour codes. Special colour properties, supported in the data feed such as GOLD, SILVER, or MULTI are other possible return types. These are to be used to generate swatches matching these specific properties.
Name
Type
Description
colors
string[]
An array with 1 - 3 CSS colour codes for SwatchType COLORS. Empty for other types.
Example: "#FF0000"
type
string
Type of colour swatch for the product. Supported values: MISSING_COLORS, COLORS, SILVER, GOLD, MULTI.
The identifier for the facet value, used by Elevate to determine which facet value has been selected. Should only be used when creating facet query-parameters.
Typed custom attributes of the variant. Only available on the product-page productGroup and when using the query parameter 'presentCustom' requesting typed custom attributes.
Width of the variant. Undefined if omitted during import.
×
Copyright
This online publication is intellectual property of Voyado Lund AB. 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 Voyado Lund AB 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. Voyado Lund AB 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.