Safely work on isolated instances of your project with environments. Environments are for making changes to your GraphQL schema, and testing out new content types without breaking your production implementation, not to be used for editorial workflows.

Depending on your current user role, and payment plan, you can manage your environments from your project settings.

Learn more about working with multiple environments

Create environmentsAnchor

You can create environments using our UI by following these steps.

Switching environmentsAnchor

You can switch environments using our UI by following these steps.

Environment endpointsAnchor

Each environment has its own API endpoint, with the alias of the environment appended to the URL.

API endpoints for both master and dev environments would follow the format of:

Promoting environmentsAnchor

When you have made the necessary changes to a schema you want to promote to the master environment, you can do this by renaming the newly created environment to be master, overriting the existing master to be named something else.

Since environments contain their own content, and webhooks, you will want to make sure you clone a new environment right before you apply the changes and promote, this ensures no loss of data.

For projects with multiple users managing content at the same time you make changes to the schema inside an environment, you will probably want to use the Management SDK.

Click here for some extra information on how to use our UI to promote an environment to master.

Delete an environmentAnchor

You can delete environments using our UI by following these steps.