This is the early access documentation preview for Custom Views. This documentation might not be in sync with our official documentation.
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 hierarchy of environments is the following, where 1 is the highest level.
- Production
- Staging
- 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.
Schemas
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.
Alternatively, you can test the component directly in staging once it's developed. This will save some time.
