Workbook versions and version history

Workbooks have versions. The default versions are Published and Draft, and you can add new custom versions called "tagged versions". For more information see Edit, draft, and publish a workbook.

Workbook version history is a list of all prior publications. Each published version listed contains a detailed list of edits, called the edit history. Both the version and edit histories are helpful when reviewing drafted changes, comparing or reverting to older published versions, or identifying who on your team made a specific edit or set of changes. There is no limit to the retention period of Workbook version history.

Requirements

• Workbook version history, including edit history and any edits to the current draft, is only available for users with Can Edit permission on a workbook.
• Only users with Can Edit permission can restore old versions of a workbook.
• Edit history was not available prior to 12/13/2022. Beginning 12/13/2022, all organizations with Live Edit enabled track edits in the edit history. Edits made prior to Live Edit being enabled remain untracked. For more information see Workbook collaboration with Live Edit.

Workbook versions overview

You can access Workbook versions from the Versions menu, next to the workbook name in the title bar. The Versions menu displays as PUBLISHED or DRAFT. Select the View version history option.

A workbook can have one of the following versions:

• Draft: While you are editing a workbook, it is in draft mode and is only visible to you.
• Published: When you are ready for other people to see the workbook, you publish it.
• Tagged: If you want to have a read-only version of a workbook, you create a tag and use it to provide more context for the state of the workbook. For example, you may tag a workbook as "Development" or "Production". You can tag a version from the Tag this version menu option. For more information see Version Tagging.

For more information, see Edit, draft, and publish a workbook.

Access a workbook's version history

1. Click the workbook header's version menu, which is labeled either PUBLISHED or DRAFT.
2. Select View version history.
   Sigma opens the VERSION HISTORY panel, with a list of versions. 

_**

💡

To see a version's edit history without opening the version, click the downward pointing chevron to the left of the version name.

3. Click the version you would like to view.
   Sigma:
   • Loads the version you selected into the canvas.
   • Changes the version menu to show the name of the version.
   • Changes the Edit link to Go back to latest version.
   • Expands the edit history list for the most recent changes. It shows the name of the editor, change activity, and date and time of the changes.
4. When you select a version entry, Sigma shows the workbook as it was at that point in time.
5. Use the version history options as described in the following section.
6. To close the version history panel, click the X button.

Version history options

Each version in the VERSION HISTORY list has a More menu to its right with the following options:

• Restore version as draft: Resets a published version to be a draft. When you restore an older draft, newer versions remain available in the version history.
• Edit name and description: Change the name and description of a version.
• Save as a new workbook: Save the version as a new workbook.
• Copy link: Copy a link to the version.
• Set tag on this version: Add a version tag. The tag must already exist. For more information see Version tagging. The Set Tag on Version modal includes additional options:
  • Allow saving as a new workbook: Gives users Can View access to the data sources used in the tagged copy, if they have permission to the tagged workbook. Allows "Save As" to work without errors. 
  • Swap sources of the tagged version: Allows this tagged version to use a different data sources than the original. 
  • Select version of dataset to use on tagged version: If there are multiple versions of a dataset used with the workbook, Sigma selects the newest published version. You can select a different version. If there are no datasets used by the workbook version, this option not applicable.

💡

The Set Tag on Version modal is also available from the Version button menu's Tag this version option.