Skip to content

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, think about this as the configuration of your current zone. Once default environments are created, Version Zero is automatically deployed to them, guaranteeing no disruption in your live traffic. This Version is also permanently editable. In case you decide to disable Zone Versioning, Version Zero will become your zone again.
  • Global Configuration, you can find all the configurations here that are not supported by Version Management.

On the Environments page, you can create default 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:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. Go to Environments.
  5. Select Create Environment.
  6. Provide the following information:
  • 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.
  1. Select Create.

Edit environment

To edit an environment:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. Select Environments.
  5. On a specific environment, select Edit.
  6. Make any required changes.
  7. Select Save.

Change environment version

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.

Promote a version

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

To promote a version:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. Select Environments.
  5. 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.

Promoting a version to a read-only environment will make the version permanently read-only.


Roll back a version

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

To roll back a version:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. Select Environments.
  5. On a specific environment, select Roll back.

Delete environment

To delete an environment:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. Select Environments.
  5. On a specific environment, select Edit.
  6. Select Delete Environment.