Convert the Version of Your Tableau Files with This Handy Tool

By Guest Author 2016/06/09

Note: The following is a guest post by Tableau Zen Master Jeffrey Shaffer. Please note: This tool and the outlined processes are not supported by Tableau.

I convert Tableau files from one version to another version quite frequently. From students at the University of Cincinnati to people at the office, to working on the Big Book of Dashboards with various people from around the world, I've had to convert all sorts of Tableau files.

I find that more often than not, it's just a single version of Tableau. For example, someone is on Tableau 9.2 when the current release is Tableau 9.3. But sometimes it's a few releases off.

When opening a newer file in Tableau, there is a warning message.

This can often be resolved by hacking the TWB file, which is an XML file. There are two places where the version is set, the workbook source and the database source. This isn't foolproof as the structure of the XML can change from version to version as new features are implemented. However, I've had pretty good success with this, especially when converting from releases that are close to each other.

I decided to create a web-based conversion tool. This tool opens a TWB file in memory and loads the contents in a window, converts the version of Tableau, then saves a new TWB file. Click here or the image below to try it.

How to Convert a TWB File

First, select your TWB file, for example a TWB in Tableau 9.3. The TWB file will show in the text window.

Next, select the version of Tableau that you wish to convert it to from the dropdown box. The TWB file will be modified.

Finally, click the save button to save the new TWB file. The new TWB file will be downloaded into your download folder appended with the name "[your file name] Tableau v9.x]." So just open a file, select your version, and then save.

This is super-simple and even works on a mobile device, taking a TWB file from Dropbox. When you open, you might have to repoint to the data source depending on what it is.

How to Convert a TWBX File

TWBX files are zip files. They contain a TWB file along with the data files and images. This requires one additional step once you have the TWB saved.

First, select the TWBX you want to convert. The zip file will unpack in a list on the screen. Find the TWB file in that list and click on it. Then select the Tableau version that you want to convert to. Then click "save as a TWB" and it will download in your download folder.

Once you have the new TWB file downloaded, open the TWBX file with a zip-file utility (for example, 7-Zip). Delete the TWB file that is in the zip file, and add the new TWB file that you just downloaded. You should now be able to open the TWBX file in an older version of Tableau.

Note: I have added functionality for Tableau 10, but it's still in beta. I have tested various conversions, different connection types, and multiple connections. This may change with future releases as new functionality in the XML or other changes may affect the conversion.

I hope you find this information helpful. If you have any questions feel free to email me at

For more tips, tricks, and vizzes by Jeff, visit his Tableau Public page, check out his blog, and connect with him on Twitter @HighVizAbility.


Submitted by Kenneth Black (not verified) on


I woke up today and found a link to this article in Linked-In. I had to laugh because I also wrote a piece on this topic yesterday: As always, thanks for sharing this!


Submitted by Guillermo M. on

I sent an email to a lot of folks internally with the same basic instructions. It blew away their mind. Maybe we can see about adding this in future versions like a compatibility warning to downgrade.

Submitted by Laura S. on

Does anyone know if works when trying to downgrade from the BETA version to the currently active desktop version? Meaning, if I use Tableau 10.0 BETA to make a workbook will I be able to use this method to convert it to 9.3 so my coworkers can access it?

Submitted by Dmitry C. on

I will work as long as you don't use cross-database joins.

Submitted by John Little (not verified) on

So this only changes the version tag in the xml?

Submitted by Anoop M. on

Excellent Tool...Like they say..simple ways are always powerful :-)

Submitted by Alexandre A. on

Excellent Tool! Thanks a lot.

Submitted by b (not verified) on


Submitted by Ian W. on

Worthless tool for me. It's a great idea, but the data security issues this raises, particularly with this not being officially supported by tableau make this tool worthless to me.


non-humans click here