Cloudflare Docs
Version Management
Cloudflare Docs
Version Management
GitHub icon
Visit Version Management on GitHub
Set theme to dark (⇧+D)
  1. Products
  2. Version Management
  3. How to
  4. Manage environments

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 configurations of your current zone. Part of your products currently visible in the navigation are going to be displayed under Versions and the other ones under Global Settings. 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 Settings, you can find all the settings 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.