Skip to main content

Create and Manage Test Case Versions

Create a Test Case version, choose a default or context-specific active version, and manage earlier versions without confusing viewing with execution.

Create a new Test Case version when the behavior or test instructions change and you want to keep the earlier version available. Versions share the Test Case key, such as DEMO-C46, but have their own version number and optional name.

Understand the version labels

Label or action

What it means

Selected version

The version you are currently viewing in the Test Case page. Opening it does not by itself change the default or active version.

Default version

The Test Case’s default selection when a workflow does not specify another version. The DEFAULT badge is a selection setting, not an approval.

Active version

The version selected for a particular linked work item, folder, or plan context. Different contexts can use different versions.

Archived version

An earlier version hidden from the normal version selector. Restore it before choosing it as the default or active version.

Check the displayed version and linked context before editing or executing a case. Do not assume that changing the default switches every existing requirement or Test Plan to that version.

Create a new version

  1. Open the Test Case and expand the Version menu near the top of the page.

  2. Select Create new version.

  3. Enter a useful Name, such as Updated sign-in flow. Names can contain up to 25 characters; use a different name from the case’s existing named versions.

  4. Under Copy from, choose the existing version to use as your starting point.

  5. Optional: select Set default. Leave it unchecked if you only want to create the version for review or a particular context.

  6. Select Create and wait for confirmation. Review the copied content and data before making changes.

Test Case Version menu showing Create new version and Manage versions

Create Test Case Version dialog with Name, Copy from, Set default, and Create

The new version copies the selected version’s case details and supported script, links, labels, components, attachments, and Test Data Collection information. Review the copy before testing; creating a version is different from creating a separate Test Case.

View or change the default version

  1. Open the Version menu and choose a version to view its content.

  2. To review all versions, select Manage versions.

  3. To change the default, open the intended version’s More menu and select Set default.

  4. Confirm the DEFAULT badge is on the intended version.

Manage Test Case Versions showing the DEFAULT badge and version actions

You can rename a version from the version manager. Setting an earlier version as the default changes the default reference; it is not an automatic rollback of every execution or link.

Choose the active version for a requirement

  1. Open the version manager from the linked work item, Test Folder, or Test Plan context you want to change.

  2. Check the context name displayed in the manager.

  3. Open the intended nonarchived version’s More menu and select Set active.

  4. Review the confirmation and select Yes. If the version is not yet linked to that context, the confirmation explains that it will be linked.

  5. Return to that context and verify its selected version before executing.

If Set active is missing, check that you opened the manager from a linked context. Creating, editing, and archiving versions also depend on your Vansah permissions.

Archive or restore a version

From Version → Manage versions, open a version’s More menu and choose Archive or Restore. The UI prevents archiving the default version; choose another default first.

After restoring, confirm the version appears in the selector. Review its content and choose Set default or Set active separately if needed. Archiving is different from deleting a Test Case.

If an action reports an error, refresh the version manager and check the saved state before trying again.

Watch the walkthrough

The video shows the create and manage workflow in an earlier interface. Follow the current labels and context checks described above.

Did this answer your question?