Sitecore Experience Accelerator

Create a JSS tenant and site

Sitecore JavaScript Services (JSS) lets front-end developers build a JavaScript app on top of Sitecore. SXA lets you create JSS tenants and sites that make it easier to work with JSS apps. The JSS tenants and sites help you scaffold your site and help you to import your JSS app in a structured way.

To create a JSS tenant and site:

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

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

  3. To create a JSS site, right-click the JSS Tenant, click Insert, JSS Site.

  4. In the wizard, on the General tab, enter the name for the site.

  5. On the Modules tab, select the modules and click OK.

    Note

    On the Site Settings tab, you can modify the GraphQL endpoint and Deployment secret but it's best practice to add these later.

  6. Click OK to create the JSS site.

    SXA creates the site with the following structure:

    Folder

    Subfolder

    Description

    Home

    Contains the site pages.

    Media

    Includes all the media items available for the site,

    Data

    Contains the data sources that can be reused across multiple pages within the website.

    Dictionary

    Multilingual apps will need a dictionary of static phrases that require translation. JSS imports translations to this folder.

    Presentation

    Page Designs

    JSS sites come with SXA page design functionality.

    Partial Designs

    JSS sites come with SXA partial design functionality.

    Placeholder Settings

    JSS sites come with SXA placeholder settings functionality.

    Settings

    Contains the default configuration items that make the app work. Customization is possible. For example, if you want to use a new template for your pages.

    Site Grouping

    SXA lets you define sites using the Site Grouping items. Contains all the data needed for the site definition such as the host name, the start item, and the virtual folder.

    By default, SXA JSS sites are using live mode. In live mode, Sitecore reads the website content from the master database.

    SXA-JSS-live-mode.png

    If you want switch to the web database, you must publish both the API keys and the SXA JSS site.

When you have finished creating your JSS tenant and site, you can start importing your app.