Cloudflare Docs
Version Management
Edit this page on GitHub
Set theme to dark (⇧+D)

Manage versions

A version is a collection of configuration settings related to your zone, such as WAF custom rules and other optimization settings.

​​ Create version

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.

If you need to test out different implementations of configurations at the same time or multiple types of changes, create a new version of your zone.

To create a new version:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. On an existing version, select Clone. This will copy over all configuration settings from that version.
  5. If needed, you can also Edit Description to provide more detail about the purpose of this version.

​​ Change settings in a version

Your zone settings are split up into two areas: Global Settings and different versions.

  • Global settings control the non-versionable settings of a zone and - when changed - automatically apply to all versions of your zone.
  • Version settings update the versionable settings of your zone and are:

​​ Editable versions

Before making changes, make sure you are inside the correct version of your zone.

To change between different versions of your zone:

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

You can also change which version you are in from any page by using the sidebar dropdown.

Select a version from the Versions page or the sidebar dropdown

From within a version, you can update settings just as you would with your normal zone settings. Any changes are saved automatically.

​​ Read-only versions

Production is a read-only environment by default. This means that any version associated with Production also becomes read-only. This setting prevents another member of your account from accidentally editing the version associated with your live traffic. You can change this setting by editing the environment.

In order to change settings in a version associated with a read-only environment, either:

  • Change the environment version to another version and then make changes to your version.
  • Edit the environment’s settings to remove the Read-only environment setting. Then, promote a new version to this environment.

​​ View metrics

Once you begin sending traffic to an environment with a version applied, you can also view metrics about what happens to that traffic.

To view metrics:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. On an existing version, select View Metrics.