Working with environments

Environments in the Studio let you manage different version of your website for development, staging, and production.

General concepts

In the Studio, you can work in the following environments:

  • Production: the information source for the live deployment of your website.
  • Staging: the information source for the staging deployment of your website.
  • Development: the information source for the extension runner during development.

To switch between environments, use the drop-down in the top-right corner.

The Studio homepage with environment drop-down open with the following options: Production, Staging, and Development.

The hierarchy of environments is the following, where 1 is the highest level.

  1. Production
  2. Staging
  3. Development

Information available in a higher level environment is also available in a lower level environment. As an exception, information in the Media, Teams, and Redirects areas is the same in all environments.


You define schemas for components, data sources, page folder settings, and project settings.

Dynamic pages are a special case and are discussed in a separate section below.

You can upload a schema to any environment in the Studio and consume the schema in the Studio environment it's uploaded to and all environments below it, which means any updates to the schema will reflect in the current environment and those below it.

Re-uploading a schema that’s available in 2 or more environments will update it across environments no matter which environment you upload it to. For example, if a data source schema is in all 3 environments and you re-upload it in the Development environment, it will also change in the Production and Staging environment.

Page versions and folders

You can create a new page folder in an environment same or lower than the parent page folder. The updates to page folders can only be made in the environment they were created. If you promote a page folder from Staging to Production, you'll be allowed to update the page folder settings in the Production environment only.

You can create and update page versions only in the environment the parent page folder was created. Hence, it's recommended to create a new page folder in the Staging environment and make all the changes to it there for testing, and then promote it to the Production environment.

Dynamic pages

Dynamic page schemas can only be created in the Production environment. Once uploaded, you can make updates to the Dynamic page rules and page versions in the environment they're created — just like the site builder.

Page templates and component groups

Page templates and components groups follow the general rule of environments: they can be edited in the highest environment they're present in.

Project settings

Unlike a project setting schema, the project settings are environment-specific, which means that if you re-upload the schema the layout of the project settings page will change across environments but the values set to different settings will still be different for different environments.

Example usage

Let's understand working with environments with the help of an example.

Consider your team has to develop a new component. The diagram below depicts the component's journey through different environments.

1c7de10 component dev staging prod

Alternatively, you can test the component directly in staging once it's developed. This will save some time.

65f441c component in envrionments