Create a new tenant and site with commerce features

Version: 9.0

You can create new tenants and sites using wizards in SXA. The SXA Storefront solution extends the wizards to include additional commerce features. In order to include those features in new sites and tenants that you create, you must select the relevant modules when you run the Create a tenant wizard and the Create a new Experience Accelerator site wizard.

To see how to create a tenant and site, watch the videos below.

Create a commerce tenant

To create a site with commerce features, you must first create a tenant that includes the Commerce Foundation feature.

To create a commerce tenant:

  1. Create a tenant.

  2. In the Modules section, select the Commerce Foundation check box together with other features that you want to include.

When you run the wizard with the Commerce Foundation module selected, the tenant that is created contains templates that support commerce storefront sites in addition to the standard SXA templates.

Create a commerce site

You can use the Create a new Experience Accelerator site wizard to create sites with support for commerce features.

To create a commerce site:

  1. In the Content Editor, select the commerce tenant, and create a site using the Create a new Experience Accelerator site wizard.

    Note

    When you create a storefront using SXA Storefront modules, on the General tab, in the Language field, select English (en). From SXA Storefront version 1.0.2, you can select one or more additional languages on the Modules tab. You can also add languages after you create the site.

  2. On the Modules tab, select one or more of the Commerce modules, together with other modules that you want to include.

    You can select the following Commerce modules:

    Module

    Comments

    Commerce Storefront Components

    Installs all Commerce renderings in the SXA Toolbox. You can use the renderings to create commerce sites.

    Also creates a site entry under the Commerce Storefront Control Panel, which is required by the Commerce Foundation layer and Commerce renderings.

    When you select this module without selecting the Storefront Template module, only a single empty home page item is created. You can then use the Commerce renderings to build your own storefront pages.

    Important

    To use any part of the SXA Storefront functionality, you must enable this module.

    Commerce Storefront Habitat Catalog

    Sets the Habitat demonstration catalog as the default catalog for the site. The Habitat catalog items will be available under the Product catalog item for the site (/sitecore/content/[tenant]/[site]/home/Product Catalog), and the Habitat catalog images will be available in the Media folder for the site (/sitecore/content/[tenant]/[site]/Media).

    Note

    From SXA Storefront version 1.0 update 2, the catalog is in the /sitecore/content/[tenant]/[site]/home/Catalog folder.

    Requires the Commerce Storefront Components module.

    Commerce Storefront Language - Danish

    Commerce Storefront Language - German

    Commerce Storefront Language - Japanese

    For each language that you select, Sitecore adds an additional language version and includes translated default content.

    Note

    Requires the Commerce Storefront Template module.

    Commerce Storefront Template

    Installs the Storefront template site. This provides you with a pre-built storefront with standard pages and functionality using SXA and Commerce renderings, page designs, and partial designs.

    Note

    Requires the Commerce Storefront Components module.

    Note

    To deploy the full SXA Storefront with the Habitat catalog you must create a tenant and site with all commerce modules enabled. To add Commerce modules to a site after site creation, right-click on the site and select Script, Add Module.

  3. On the Theme tab, select the themes that you want to apply to your site.

    If you select the Create new theme check box, a simple, unbranded new theme is created. If you have selected the Commerce Storefront Components feature on the Modules tab, the new theme  includes support for the commerce renderings. Support does not include layout and the component styling is minimal. The theme includes all the component Sass files;however, some of the files are empty. This makes it easier to export the theme using Creative Exchange.

    Note

    If you select the Commerce Storefront Template check box on the Modules tab, the Storefront Branded, Storefront Mock-up with product images , and Storefront Mock-up with mock images themes are installed.

    The Commerce renderings do not support the Wireframe theme. Mock-up themes have been discontinued and, for this reason, have "deprecated" appended to the theme name. To browse to them in the Content Editor, you navigate to the sitecore/Media Library/Themes/Storefront deprecated folder. You can, however, still use these themes when you create new sites.

  4. On the Grid tab, select the bootstrap grid system. SXA Storefront supports only Bootstrap 3.

    Important

    The Commerce Storefront Template module is only compatible with the Bootstrap grid system. If you select the Commerce Storefront Template check box on the Modules tab, then you must select the Bootstrap check box on the Grid tab.

Security

From SXA Storefront version 1.0.2, when you create a new site with the Create a new Experience Accelerator site wizard, a security domain and two new extranet user roles are created.

Commerce Engine Configuration

In Commerce Engine, you configure allowed domains with the Sitecore.Commerce.Plugin.Customers.CustomerPropertiesPolicy policy as part of the environment. A system administrator needs to update the configuration of the Commerce Engine environment to include the new domains that are created for each site in SXA Storefront. For more information about updating the Commerce Engine configuration, see the Commerce DevOps Guide.

Do you have some feedback for us?

If you have suggestions for improving this article,