Sandbox environments start out as exact copies of one of the existing environments (ie. the primary one). The process of creating a new sandbox starting off from an existing environment is called fork.
Each environment is identified by a name (ie. master
) and stores the following information:
Models
Records
Uploads
Plugins
Locales and timezone settings
UI Theme (colors and logo)
Global SEO settings
The content navigation bar
When making changes to any of the aforementioned entities in any environment, including the primary environment, the data in all other environments isn’t affected and stays the same.
Inside the Settings > Environments section you can manage all your project's environments. To create a new sandbox starting off from an existing one, just click the Fork button and choose a name for the new environment.
DatoCMS will perform a deep copy of all the information contained inside the source inside the new sandbox:
Once there's at least a sandbox environment, developers will be able to switch environments using the top bar panel.
Editors will never see the this panel thanks to a reduced set of permissions, and will continue their editorial workflow on the primary environment as usual.
At any time you can promote a sandbox environment to become the new primary. The old primary environment will be demoted as sandbox environment, and content editors will immediately see the interface refresh. From that moment, they will only be able to see and make changes to the new primary environment: