Work with Content Revisions

When you publish a workbook or data source, a version is saved in the revision history for Tableau Server and Tableau Cloud. You can revert to a previous version at any time.

Required permissions for revision history

To access revision history, you must have a site role of Creator or Explorer (Can Publish), plus the following permissions, depending on the content type: 

  • Project: View and Save

  • Workbooks in the project: View, Save, and Download Workbook/Save As

  • Data sources in the project: View, Save, and Download Data Source

For virtual connections in the project, you must have a Creator site role and the View and Overwrite permissions. See "Use a Virtual Connection" in the Tableau Cloud(Link opens in a new window) or Tableau Server(Link opens in a new window) help for details. (Virtual connections require Data Management. See About Data Management(Link opens in a new window) for details.)

Publish your content

In Tableau Desktop, click ServerPublish Workbook or ServerPublish Data Source. Make changes to the workbook or data source, and then publish it again to the same project, with the same name. (You’ll need to confirm that you want to overwrite the existing content.)

You can also save workbook revisions by editing and saving a workbook in the web-authoring interface of Tableau Server and Tableau Cloud.

View revision history

  • Click the actions menu (. . .) for a workbook or data source, then click Revision History.

    The following image shows a workbook's revision history.

Manage revisions

Preview a workbook revision

  • From a revision’s actions menu (. . .), click Preview.

    If a preview is available, it opens in a new tab in the browser. For workbooks that you can't preview on the server, such as those with OAuth data connections, you can download the revision and open it in Tableau Desktop.

Download a workbook or data source revision

  1. From a revision’s actions menu (. . .), click Download.

  2. Open the downloaded file in Tableau Desktop.

Restore a workbook revision

  • In the revision history, select a revision, and then click Restore.

    The restored version becomes the current version.

    Note: If a revision can't be restored directly on the server, download the revision, open it in Tableau Desktop, and republish it.

Restoring workbooks that require database credentials

If a workbook uses a live data connection that prompts for a user name and password, you have the option to embed credentials for the connection. If the workbook uses a data source with multiple connections, you might need to provide credentials for each one.

If a workbook uses data extracts with scheduled refreshes and embedded credentials, you’ll need to edit the data connection to provide the credentials.

Restore a data source revision

For a variety of reasons—for example, extracts commonly are on refresh schedules—a previous revision of a data source will not include the extract as it was published at the time. To restore the extract, you can download the previous revision of the data source (in .tdsx format), open it in Tableau Desktop, and re-publish the extract.

For more information, see Data changes and deletions under Potential revision history issues.

  1. Sign in to the Tableau Server or Tableau Cloud web editing environment, navigate to the data source, and open its revision history.

  2. From a revision’s actions menu (. . .), click Download .

    Screen shot of the Download menu

  3. Open the downloaded file in Tableau Desktop, and then republish it with the same name, to the same location on your Tableau Server or Tableau Cloud site (confirming that you want to overwrite the existing version).

    The uploaded version becomes the most current version.

Delete a workbook or data source revision from history

  1. From a revision’s actions menu (. . .), click Delete.

    The revision history list updates to indicate a revision has been deleted.

Potential revision history issues

Overwriting content with the same name

If a different author publishes over a workbook or data source with the same name, the most recent author becomes the owner of the content and can see its entire revision history.

Data changes and deletions

  • Workbooks and data sources are downloaded with the latest configuration of their extract or data connection. If the data model or data connection has changed between revisions, you might need to update the downloaded workbook or data source.

  • Revisions of workbooks and data sources that use .xls or .csv files are saved with an extract of that data.

  • Revisions are saved for .hyper files with a direct connection. Revisions are not saved for extracts.

  • If a workbook or data source is deleted from a site, all revisions are also deleted.

Turning revision history on and off

On Tableau Server, server administrators can disable revision history for specific sites.

If revision history is turned on and then off, saved revisions are retained, and new versions overwrite the latest version. If revision history is then turned on again, version numbering starts from the last saved revision.

If you’re a Tableau Server administrator, see Enable Users to Save Revision History(Link opens in a new window) for more about revision history settings.

Thanks for your feedback!Your feedback has been successfully submitted. Thank you!