Create a tenant and a site

Last updated Monday, October 16, 2017 in Sitecore Experience Accelerator for Content Author

The SXA content architecture includes tenants and sites. SXA supports multitenancy, which means that you can run multiple sites on a single instance of Sitecore. Each tenant can include multiple related sites, for example, to support multiple brands for a single company or multiple languages or locations for a single brand. Organizations can support multiple languages through one-to-one translated versions (native Sitecore language support) or use a model with a separate site for each supported language.

For example, an international clothing company could have different tenants for the different brands of clothing and different sites for the specific countries.

This topic describes how to:

Create a tenant and a tenant folder

With SXA's multitenant architecture, you can provide each tenant a dedicated share of the Sitecore instance including its data templates, configuration, user management, tenant individual functionality, and non-functional properties.

To create a tenant:

  1. In the Content Editor, right-click the item in the content tree, click Insert, Tenant.

    Right-click the item in the tree, click Insert and click Tenant.

  2. In the wizard, enter a name for the tenant, select the features, and click OK.

For more complex solutions, you can use groups of tenants. For example, a multinational selling consumer goods could have the following tenant folders and tenants:

Company (Tenant Folder)

  • Cosmetics (Tenant Folder)
    • Brand A (Tenant)
    • Brand B (Tenant)
  • Laundry detergents (Tenant Folder)
    • Brand A (Tenant)
    • Brand B (Tenant)
    • Brand C (Tenant)
  • Hair care (Tenant Folder)
    • Brand A (Tenant)
    • Brand B (Tenant)
    • Brand C (Tenant)
    • Brand D (Tenant)

To create a group of tenants:

  • Right-click the content item in the content tree, click Tenant Folder, enter a name and click OK.

Note

If you want to move tenants between environments, you can package tenants with the SXA Tenant Exporter.

Create a site and a site folder

The tenant is a top-level container for the sites underneath. Sites in the same tenant are related, for example, because they share the same set of templates or part of the media library. Sites are the items that represent the website and consist of pages, data, designs, and partial layouts.

To create a site:

  1. In the Content Editor, right-click the tenant to which you want to add the site.

    Right-click the tenant, click Insert, and click Site.

  2. In the wizard, on the General tab, enter the name for the site.
  3. On the Features tab, select the features and click OK.
  4. On the Theme tab, either create a new theme by selecting Create new theme or select one or more existing theme(s) and click
  5. On the Grid tab, select the grid and click OK.

    Note

    It is important to be aware that changing the grid system after you create your site requires many manual changes. Because of the references on your pages to the previous grid system, making a change to the grid system will break your layout.

    Your new site is available immediately.

Note

You can create a duplicate of a site, by using the clone script.

For governance reasons, you can decide to use groups of sites. For example, for an internalization model where you create different sites for different countries:

  • Europe (site folder)
    • Poland (site)
    • Denmark (site)
    • The Netherlands (site)
    • Ukraine (site)
  • Asia (site folder)
  • Africa (site folder)

To create a group of sites:

  • Right-click the tenant in the content tree, click Site Group, enter a name and click OK.

Note

SXA defines sites as Sitecore items. This enables to mitigate an issue with website restart after each change in Sitecore.config file. You can create new sites with SXA without a need to restart your Sitecore instance. If for some reason you decide to define sites in the config file instead of using items, makes sure to add IsSxaSite="true" parameter to your site definition XML node. SXA will use this parameter to determine whether a defined site is an SXA site or not. For example:

<site name="C" IsSxaSite="true" enableTracking="true" virtualFolder="/mySXA" physicalFolder="/" rootPath="/sitecore/content/A/B/C" startItem="/Home" database="web" domain="extranet" allowDebug="true" cacheHtml="true" htmlCacheSize="50MB" registryCacheSize="0" viewStateCacheSize="0" xslCacheSize="25MB" filteredItemsCacheSize="10MB" enablePreview="true" enableWebEdit="true" enableDebugger="true" disableClientData="false" cacheRenderingParameters="true" renderingParametersCacheSize="10MB" />
Send feedback about the documentation to docsite@sitecore.net.