> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Manage workflow versions

> Workflow versioning enables you to update a workflow at the version level instead of creating a new workflow from scratch.

Workflow versioning enables you to update a workflow at the version level instead of creating a new workflow from scratch.

You can better manage your workflows with the version control feature. You can switch between different versions with only a few clicks. When you create a new workflow version, the active version and the existing API integration can still work properly.

After you open a workflow page, a version list for the workflow definition is available on the **Versions** tab. You can open and view any version. You can set an active version as the current version for the workflow. You can create a new version based on the active version or by using an imported JSON file.

The workflow version starts from version 0.0.1 by default. The version number must be unique. A new version number must be greater than the existing highest version number.

You can retrieve the workflow version information in [Data Query](/docs/platform/data/data-query/overview-of-data-query) with the **Version** field. All version changes are tracked and recorded in [Audit Trail](/docs/platform/security-and-identity/audit-trail/audit-trail-overview).

> **Note**
>
> It's important to understand the difference between workflow definition status and workflow version status:
>
> * The status of workflow definitions indicates whether a definition is triggerable: Only active definition can be triggered.
> * The status of workflow versions indicates which workflow version will be run when a definition is triggered.

> Workflow versioning enables you to update a workflow at the version level instead of creating a new workflow from scratch.

## Docs

- [Workflow versioning overview](https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/the-versions-of-a-workflow-definition.md): An introduction of the versions of a workflow definition.
- [Create a workflow version](https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/create-a-workflow-version.md): Learn how to create a new workflow version.
- [Edit a workflow version](https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/edit-a-workflow-version.md): High-level steps to edit a workflow version.
- [Set a workflow version as the active version](https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/set-a-workflow-version-as-the-active-version.md): Learn how to set an inactive workflow version as the active version.
- [Configure settings of a workflow version](https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/configure-settings-of-a-workflow-version.md): High-level introduction about configuring settings of a workflow version.
- [Delete workflow versions](https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/delete-workflow-versions.md): Learn how to delete a workflow version.
- [Export a specific version of a workflow definition](https://zuora.ferndocs.com/docs/platform/extensibility/workflow/create-and-manage-workflow-definitions/advanced-tutorials/workflow-versioning/export-a-specific-version-of-a-workflow-definition.md): Learn how to export a specific version of a workflow definition.