Configure SXA Storefront and commerce settings

Current version: 10.3

It is the Commerce Connect engine that provides the analytic functionality used in your storefront and it is installed alongside the Commerce Control Panel, which contains commerce engine and storefront settings. It is for this reason that you must configure the commerce terms, the global configuration item as well as Storefront-specific settings.

Commerce terms

A Commerce Terms folder is installed with SXA Storefront (/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Commerce Terms). Commerce Terms are used to assign user-friendly terms to status options that are used by the commerce system, such as inventory and shipping statuses. These terms are similar to the terms in the Commerce Terms folder that is installed for the Commerce Engine (/sitecore/Commerce/Commerce Control Panel/Commerce Engine Settings/Commerce Terms), but the terms in the Storefront Settings folder are specific to your storefronts.

Diagram showing Commerce terms in the Content Editor.

In the Commerce Terms/System Messages folder, you can edit system messages used on the storefront.


To create a commerce term, right-click Commerce Terms and click Insert, Commerce Term. On the Content tab, define a label and description.

Global Configuration item

When you install SXA storefront, the Global Configuration item is installed in the Storefront Settings folder (/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Global Configuration).

You use the Global Configuration item to provide configuration information that applies to all storefronts.

You use the Catalog Item Encoding fields to manage encoding values for your storefronts. In some cases, data strings imported from the commerce system can introduce errors in Sitecore. For example, a "/" in a category or subcategory name in a URL would cause the Sitecore routing table to read the string as a product rather than a category, because the string appears to contain an extra path segment.

This issue is avoided by replacing the "/" character with other characters when the URL is generated, and then reverting to "/" when searching for the category. The replacement is made based on an encoding rule in the Catalog Item Encoding field. You can add characters to encode to the list. Each time you add a character to the list, a new empty line appears at the bottom of the list.

The URL Token Delimiter field defines the character used as a separator between the catalog item ID and catalog item name. For example, if the system is configured to use Shop URLs, the separator is placed between the category ID and category display name as well as the product id and product display name.

The Encoded Delimiter field contains the encoding rule for the URL token delimiter.

Storefront-specific settings

When you install SXA Storefront, four custom configuration items are added to the /sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/<site> folder:



Account Management Configuration

Determine the maximum number of addresses that can be registered per customer.

Catalog Configuration


From SXA Storefront 1.0.2, the Catalog field and the Start Navigation Category field are deprecated. Use the corresponding fields on the /sitecore/content/[your tenant]/[your site]/Settings/Commerce/Catalog Configuration item to configure the catalog for the storefront.

The value in the Default Items Per Page field is used as the default for all categories. To change the setting for a single category, in the Sitecore/Sitecore Commerce/Catalog Management folder, change the value in the Items per page field.

The value affects the Product List rendering, and the Product List Header rendering, which allows the customer to select the number of products to show on a category or search result page.

Select the Use Direct Navigation check box to display the catalog item directly. This means that the presentation, page events, goals, analytic profiles, campaigns, and personalization are all available from the catalog item so that each category and product in the catalog can be unique in terms of presentation and analytics.

Select the Exclude Categories in Website Search Results check box to exclude the categories in which products are organized from search results.

In the Gift Card Product ID field, enter the product ID that the commerce system uses for gift cards.

The Gift Card Page Link field contains the URL for the gift card product page.

In the Shop Pages Root Paths section, the Shop Page Root Path, Category Page Root Path and Product Page Root Path fields must be set to the relative path for the items used when generating links for category and product navigation.

Renderings in the Commerce Catalog group that generate links will use the value of the Shop Page Root Path field to generate the URLs.

The Metadata meta rendering uses the values configured in the Category Page Root Path and Product Page Root Path fields to generate a canonical URL in the head section of each page that contains the rendering. Canonical URLs are used by search engines to improve indexing of categories and products.

Country-Region Configuration

Define the country code, which is used when you add a Currency Selector to the Storefront.

Storefront Configuration

Enforce SSL is enabled by default to ensure a private and secure connection between the client browser and the storefront. It is not recommended to disable this feature except during development and testing of the solution.

Currencies Display Adjustments

Define the currencies that you want available in the web shop. Right-click and select Insert Currency to add a currency to the list.

Currency Configuration

Specify the currency set available on the storefront.

Email Configuration

In the From Email Address field, enter the email address to use as the sender address for email messages sent by the storefront.

The Email Address Validation Regex contains the regular expression used to validate email addresses, for example, for the Login, Registration, and Checkout Billing renderings.

Fulfillment Configuration

Select available fulfillment options.

Language Configuration

Select the language set.

Payment Configuration

Select available payment options.

Do you have some feedback for us?

If you have suggestions for improving this article,