Restore a previous version of a Tableau workbook

How to bring back an earlier Tableau workbook revision: check revision history on Tableau Server or Cloud, use saved .twb and .twbx files, and choose what to restore.

7 min read5 viewsRestore a previous version of a Tableau workbook
— · 0 votes
Contents
  1. Where earlier workbook versions come from
  2. Reading revision history on Tableau Server or Cloud
  3. Downloading a revision before you restore it
  4. Restoring a revision on the server
  5. Using saved .twb and .twbx files
  6. Keeping your own saved versions
  7. Matching the restore to the job at hand
  8. Questions about restoring Tableau workbook versions
  9. Can I restore a previous version of a Tableau workbook on Tableau Server or Tableau Cloud?
  10. What is the difference between a .twb and a .twbx file when restoring?
  11. Does downloading an old revision change the published workbook?
  12. Does Tableau Desktop keep saved versions of a workbook automatically?
  13. How do I publish a previous workbook revision again?

You restore a previous version of a Tableau workbook from wherever the older copy lives. On Tableau Server or Tableau Cloud, that means the revision history of the published workbook. On a local machine, it means a saved .twb or .twbx file, or a version your own backup keeps.

  • Publishing creates revisions, so the server copy often holds history a local file does not.
  • A .twbx packs the workbook with its data and images, while a .twb keeps only the workbook definition.
  • Restoring a revision replaces the live workbook content, so confirm which revision you actually need.
  • Downloading an old revision first lets you inspect it before anything changes for other users.
  • Local saved versions depend on your own file naming, not on Tableau.

Where earlier workbook versions come from

A previous version of a Tableau workbook can come from two places. The first is the revision history kept by Tableau Server or Tableau Cloud for a published workbook. The second is any copy you saved yourself as a .twb or .twbx file on a computer or shared drive.

The server path is the more reliable one for workbooks that are published. Each publish action adds a revision, so the history reflects what the workbook looked like at that point. Local files only tell the story your saving habits recorded.

Decide which source holds the version you want before you touch anything. A workbook edited locally and never published has no server revisions at all. A workbook edited only on the server may have no separate local file.

Reading revision history on Tableau Server or Cloud

Revision history on Tableau Server or Tableau Cloud lists the published states of a workbook in order. You open the workbook page and find the history entry, which shows each revision with the time it was saved and the account that published it.

Selecting a revision shows what that version contains before you commit to it. Use the description or notes attached to a revision to judge which one matches the state you want back. Revision notes written at publish time make this choice much faster.

Permissions decide what you can do next. An owner or a site administrator can act on revisions, while a viewer may only see the list. Ask the workbook owner if the history is visible to you but the restore action is not.

Downloading a revision before you restore it

Downloading an older revision is the safe first step in restoring a Tableau workbook. The download gives you a separate file you can open in Tableau Desktop and inspect without changing the published workbook that others use.

Check the downloaded revision against what you expect. Look at the sheets, the data connections and any calculations that changed after that point. A workbook can look right on the surface while a broken connection sits behind a single sheet.

Keep the downloaded file as your working copy while you decide. If the revision turns out to be the wrong one, you have lost nothing and the live workbook is untouched. Rename the file so its revision point stays clear later.

Restoring a revision on the server

Restoring a revision makes that older published state the current content of the workbook on Tableau Server or Tableau Cloud. You choose the revision in the history list and confirm the restore action for that workbook.

The restore itself overwrites the current published content. Anything published after the chosen revision stops being the live version, so confirm with the people who use the workbook before you act. A short message to the team prevents confusion.

Treat the restore as a new point in the history rather than an erasure. The revisions between the old state and the present remain recorded, so you can move forward again if the restored version is not the right one. Owners and administrators handle this step.

Using saved .twb and .twbx files

Tableau workbook files come in two forms that matter when you restore a version. A .twb file holds the workbook definition, including sheets, calculations and connection details, but not the data itself. A .twbx file is a packaged workbook that bundles the definition with its data and images.

A packaged .twbx is easier to hand to someone else because it carries what it needs. An unpackaged .twb depends on a live connection or an external data file that must still exist. Restoring from a .twb fails quietly if the underlying source has moved.

Open the older file in Tableau Desktop and compare it with the current workbook before publishing it again. Publishing that file then creates a fresh revision that carries the older content. This route works when the server history is short or the file was never published.

File typeWhat it containsWhat restoring needs
Unpackaged .twbWorkbook definition onlyThe original data source, still reachable
Packaged .twbxWorkbook plus data and imagesNothing beyond Tableau to open it
Server revisionPublished state held by the platformAccess to revision history and restore rights

Keeping your own saved versions

Tableau Desktop saved versions are the copies you create yourself, and their usefulness depends on your file naming. A name that records the date and the change gives you a clear trail to step back along. A folder of files called final and final2 does not.

Save a copy before any large edit rather than after it. The moment before a restructure is the version you are most likely to want back. A short note in the file name about what changed keeps the trail readable.

Keep those copies somewhere separate from the working file. A local folder on one machine is one failure away from gone, so a shared drive or a managed backup location suits better. The site subject of keeping listings side by side applies here too, with versions rather than products.

Matching the restore to the job at hand

Choose the restore route by asking what actually changed and who needs the result. A wrong number on a dashboard points to a recent revision on the server. A broken layout after a redesign points to a file saved before that work began.

Sharing the outcome matters as much as the fix. If other people view the workbook on the server, restoring there updates what they see. If the workbook is a personal analysis, replacing the local file is enough.

Record what you did once the restore is done. A short note on which revision was restored and why saves the next person from repeating the diagnosis. That note also explains the odd step in the revision history.

Questions about restoring Tableau workbook versions

Can I restore a previous version of a Tableau workbook on Tableau Server or Tableau Cloud?

Yes, Tableau Server and Tableau Cloud keep revision history for a published workbook. Someone with owner or administrator rights selects the revision and restores it, which makes that older state the current content. Viewers who cannot see the action need to ask the owner.

What is the difference between a .twb and a .twbx file when restoring?

A .twb file holds the workbook definition and relies on an external data source. A .twbx file packages the workbook with its data and images, so the file opens without hunting for the source. Restoring from a .twb fails if the original data source has moved.

Does downloading an old revision change the published workbook?

No, downloading a revision only creates a copy for you to open and inspect. The published workbook keeps its current content until someone restores a revision or publishes again. Inspect the download first, then decide whether to restore.

Does Tableau Desktop keep saved versions of a workbook automatically?

Tableau Desktop saved versions are the copies you create by saving the file yourself. Automatic history belongs to a published workbook on Tableau Server or Tableau Cloud. Keep dated copies of your local files if you want a trail to step back along.

How do I publish a previous workbook revision again?

Open the older revision or file in Tableau Desktop and publish it to the same project and name. The publish action adds a new revision carrying the older content. Confirm the name and project so the publish lands on the workbook you mean to change.

Read next

Latest articles