Manage environments

An environment is a place to test different versions of your zone configurations.

Create environment

Once you enable Version Management, Cloudflare will automatically create:

Version Zero of your zone, which duplicates all existing settings that are compatible with version management. Since this version is initially applied to your read-only Production environment, you cannot edit any settings.
Version 1 of your zone, which is the same as Version Zero but its settings can be updated and applied to environments.
Global Settings, which controls the settings that are not compatible with version management.

Any changes made to Global Settings will immediately apply to your zone and all versions of your zone.

Cloudflare also automatically creates environments for Production, Staging, and Development.

Based on your organization’s needs, you may need to create additional environments to test and roll out changes.

To create a new environment:

Environment Name: A unique, descriptive name for the environment.
Traffic filter: Limits which requests are sent to this environment.
Initial position: Controls where this environment should be in your testing process.

To edit an environment:

To prevent accidental changes, you can only update an environment’s version through the process of Promotion or Roll back.

For more details on the flow of versions and environments, refer to How it works.

Promotion moves a version from a lower-ranked environment to the next highest one.

To promote a version:

Log in to the Cloudflare dashboard.
Select your account and zone.
Go to Version Management.
Select Environments.
On the environment in which you tested the version, select Promote. This option will only be available if the lower-ranked environment has a different version than the higher-ranked environment.

When you roll back a version, you revert the environment to the previous version assigned to it.

To roll back a version:

To delete an environment: