Join us live as we unveil the all new Hygraph Studio!

Hygraph
Docs

Environments

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 environments

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

#Switching environments

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

#Environment endpoints

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 environments

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, overriding 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 environment

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