Skip to content

Dynamic Pages

Dynamic pages is a concept which makes it possible to retrieve content from several panels at once, without pre-defining a zone for each combination of panels that might be called at once. This also enables the possibility to deduplicate products over a dynamically generated page.

A dynamic page is defined by a name, a number of sub-panels which constitute the page, and a number of arguments to the page request. Each sub-panel is in turn defined by a (for that dynamic page) unique identifying name, the path to a public panel, and a number of arguments to that panel.

Dynamic pages and Web API v2

Three major changes have been introduced with working with Dynamic pages and Web API v2.

  • All query parameters, except esales.sessionKey, esales.customerKey and esales.market, have been moved into the body.
  • All dynamic page tokens have been removed from v2 in favor of the Api-Key header in the HTTP request.
  • Dynamic pages have been removed from the JavaScript library and is now a server side request only.

Dynamic page naming

Always name a dynamic page after its use and position in the site. Never change the name of a dynamic page as this will result in inaccurate panel statistics.

The name of a dynamic page should reflect its use and position in the site structure. A dynamic page is not to be renamed after its initial publishing. All statistics are connected to their path. As the path is based on the name, statistics will be reset when the identifying path is changed.

Sub-panels of a dynamic page may only refer to the public root panels in a published panel hierarchy. It is possible to include multiple sub-panels which refer to the same public panel, however this require that the sub-panels must have unique identifying names. The advantage in using this method is that the same panel can be requested several times, but with different arguments. This also supports de-duplication.

Dynamic pages can be queried through both the JavaScript library and the RESTful API when using Web API v1, but only with the RESTful API when using Web API v2. If any required arguments is left undefined in the public panel, they must be provided in either the arguments to the sub-panel, or to the dynamic page request. Arguments that already are defined in the public panel will override any provided arguments. Arguments added to the sub-panel will override the arguments provided to the dynamic page at request time.

×