Configure the override catalog templates

Abstract

Override catalog templates that enable you to set different presentation on each catalog.

By default, catalog items are based on global commerce templates. This means that with a multisite setup, all storefront sites have the same presentation and custom fields. When you want each site to have its own presentation and custom fields, you must define override templates on each catalog so that the page type template becomes a container that inherits from other base templates, and the template-to-page design mapping determines the page design. It is the template that defines the data structure and data inheritance required to render a page. This is illustrated in the following diagram.

Note

While this topic references the storefront site template, the content also applies when using Sitecore Commerce without SXA Storefront or the storefront site template.

Overview of template types.

The following override templates are provided by default with the Storefront site template.

Note

The _SearchableWithoutRelatedItems template is only required if you are using a custom index or when the Sitecore content crawler is configured to crawl catalog content. In this case, it is important that you include it in order to reduce the time needed to index catalog content.

Override template

Base templates

Category template

  • /sitecore/Templates/Project/<tenant>/Catalog Navigation Page

  • /sitecore/Templates/Foundation/Commerce Experience Accelerator/Commerce Pages/Catalog Category Page

  • /sitecore/Templates/Commerce/Catalog/Commerce Category

  • /sitecore/Templates/Foundation/Experience Accelerator/Search/Computed Fields/_SearchableWithoutRelatedItems

Product template

  • /sitecore/Templates/Project/<tenant>/Catalog Navigation Page

  • /sitecore/Templates/Foundation/Commerce Experience Accelerator/Commerce Pages/Catalog Product Page

  • /sitecore/Templates/Commerce/Catalog/Commerce Product

  • /sitecore/Templates/Foundation/Experience Accelerator/Search/Computed Fields/_SearchableWithoutRelatedItems

Product variant template

  • /sitecore/Templates/Project/<tenant>/Catalog Navigation Page

  • /sitecore/Templates/Foundation/Commerce Experience Accelerator/Commerce Pages/Catalog Product Page

  • /sitecore/Templates/Commerce/Catalog/Commerce Product Variant

  • /sitecore/Templates/Foundation/Experience Accelerator/Search/Computed Fields/_SearchableWithoutRelatedItems

Static bundle template

  • /sitecore/Templates/Project/Sitecore/Catalog Navigation Page

  • /sitecore/Templates/Foundation/Commerce Experience Accelerator/Commerce Pages/Catalog Product Page

  • /sitecore/Templates/Commerce/Catalog/Commerce Bundle

  • /sitecore/Templates/Foundation/Experience Accelerator/Search/Computed Fields/_SearchableWithoutRelatedItems

Dynamic bundle template

  • /sitecore/Templates/Project/Sitecore/Catalog Navigation Page

  • /sitecore/Templates/Foundation/Commerce Experience Accelerator/Commerce Pages/Catalog Product Page

  • /sitecore/Templates/Commerce/Catalog/Commerce Dynamic Bundle

  • /sitecore/Templates/Foundation/Experience Accelerator/Search/Computed Fields/_SearchableWithoutRelatedItems

To override the templates used by the data provider:

  1. In the Content Editor, go to /sitecore/Content/<tenant>/<site>/Home/Catalogs.

  2. Select a catalog.

  3. On the Content tab, in the Template Overrides section, for each template type, click in the field and map the override template to a project template in the Templates/Project/<tenant> folder.

  4. For your changes to take effect, on the ribbon, on the Commerce tab, click Refresh Commerce Cache.

After you define the override templates, you must configure the catalog presentation. If you are configuring direct navigation, you must enable it on the storefront site.