Cloudflare Docs
Version Management
Visit Version Management on GitHub
Set theme to dark (⇧+D)

Enable Version Management

By default, Version Management is not enabled on a zone.

To enable Version Management:

  1. Log in to the Cloudflare dashboard.
  2. Select your account and zone.
  3. Go to Version Management.
  4. Select Enable versioning.

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.

​​ Disable Version Management

To disable Zone Versioning:

  1. Deploy Version Zero to your Production environment. When you disable Zone Versioning, all your zone settings will revert to those in your Version Zero, so you should validate these settings are correct before proceeding.

  2. Send a GET request to the /accounts/{account_id}/rulesets/phases/http_request_select_configuration/entrypoint endpoint.


    curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/rulesets/phases/http_request_select_configuration/entrypoint" \
    --header "X-Auth-Email: <EMAIL>" \
    --header "X-Auth-Key: <API_KEY>"

    In the response, save the following values:

    • The top-level ruleset id.
    • The rule id of every rule that has the zone’s name as the zone field in the expression property.
  3. Using the id of those rules, send DELETE requests for every rule in the ruleset.

  4. Then, send a GET request to find all HTTP applications (or versions of your zone).


    curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/http_applications" \
    --header "X-Auth-Email: <EMAIL>" \
    --header "X-Auth-Key: <API_KEY>"

    Save the id of each HTTP application.

  5. Using the id of those HTTP applications, send DELETE requests for every application.


    curl --request DELETE "https://api.cloudflare.com/client/v4/zones/{zone_id}/http_applications/{http_application_id}" \
    --header "X-Auth-Email: <EMAIL>" \
    --header "X-Auth-Key: <API_KEY>"

Once all these steps are completed, Zone Versioning will go back to its original landing page.