How to Unpackage a Tableau Workbook

Ever received a Tableau workbook file and realized you need the raw Excel or CSV data file that was used to create it? Or perhaps you love the custom icons on a dashboard and want to use them yourself? This is exactly what unpacking a Tableau workbook is for. This straightforward guide will show you precisely how to unpackage a Tableau workbook (.twbx) to access all of its component parts, from the data sources to custom images.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

What’s the Difference Between .twb and .twbx Files?

Before we jump into the "how," let's quickly clarify what we're working with. Understanding the difference between a standard Tableau Workbook (.twb) and a Packaged Workbook (.twbx) is foundational to knowing why you need to unpackage one in the first place.

Think of it like the difference between a recipe and a complete meal-kit box.

Tableau Workbook (.twb)

The .twb file is the recipe. It's a small XML file that contains all the instructions Tableau needs to build your visualizations. This includes things like:

• Which sheets, dashboards, and stories are included.
• The fields being used on your rows, columns, and marks cards.
• All the formatting, colors, and font choices.
• Calculated fields you've created.

A .twb file does not contain the actual data. It only holds a reference to the data source, whether that's a server connection, an Excel file on your C: drive, or a Google Sheet. If you send someone just the .twb file without giving them access to the data, they won't be able to see anything.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Tableau Packaged Workbook (.twbx)

The .twbx file is the meal-kit box. It bundles everything needed to view the workbook in one convenient package. It contains:

• The .twb file (the recipe).
• A copy of any local data sources (e.g., Excel files, CSVs, text files).
• Copies of any Tableau Data Extract (.hyper or .tde) files.
• Any custom images (backgrounds, logos) or custom shapes used in the visualizations.

Because the .twbx file bundles the workbook and its local data sources together, it’s the perfect format for sharing with team members who don’t have access to the original data's location. When you need to get at those individual files inside the "box," that’s when you need to unpackage it.

Why Unpackage a Tableau Workbook?

Beyond curiosity, there are several practical scenarios where unpackaging a .twbx becomes incredibly useful.

• Accessing the Original Data Source: This is the most common reason. A colleague sends you a .twbx for feedback, and you realize you need the underlying spreadsheet to check a number or add a new column. Unpackaging lets you pull out that exact Excel, CSV, or .hyper file.
• Extracting Custom Assets: Have you ever seen a dashboard with beautiful custom icons or a sleek background image? By unpackaging the workbook, you can access the "Images" or "Shapes" folder and grab those assets for your own projects.
• Troubleshooting and Editing Data Connections: Sometimes, you might want to switch a workbook from a static, local file to a live database connection. Unpackaging it gives you access to the .twb file, making it easier to edit and redirect the data source.
• Archiving Data: Let's say a workbook is being retired, but you want to save a snapshot of the data used for a particular report. Unpackaging allows you to store the raw data and the workbook structure separately.
• Advanced XML Edits: For power users, you might want to edit the XML in the .twb file directly to implement undocumented formatting tweaks or perform batch changes. You can only do this after unpackaging the workbook.

How to Unpackage a Tableau Workbook: Two Simple Methods

You have two main paths to unpackaging a .twbx file. The first is the "official" way through the Tableau Desktop application, and the second is a clever manual workaround that highlights how a .twbx is structured.

Method 1: The Standard Way (Using Tableau Desktop)

This is the easiest and most recommended method, as it's built directly into the software and is virtually foolproof.

1. Open the Workbook: Start by opening your .twbx file in Tableau Desktop.
2. Navigate to 'File': Once the dashboard or worksheet is loaded, go to the menu bar at the top-left of the screen and click on "File."
3. Select "Unpackage Workbook": In the dropdown menu, you'll see an option called "Unpackage Workbook." Click it. In some older versions, this might be labeled just "Unpackage."
4. Choose a Save Location: A "Save" dialog box will appear. Navigate to the folder where you want to save the unpackaged contents and click "Save."
5. Check Your Files: Now, navigate to that location in your file explorer. Tableau will have created the .twb workbook file and a companion folder with the same name, which contains subfolders for "Data" and, if applicable, "Images" or "Shapes." All your source files are now accessible.

Method 2: The Manual Way (Renaming to .zip)

This method reveals a little secret about the .twbx format: it's just a zip file with a custom extension. You can use any standard unzipping utility to open it up.

A quick word of caution: Before you start changing file extensions, it's always smart to make a copy of your original .twbx file, just in case.

1. Locate Your File: Find the .twbx file in Windows File Explorer or macOS Finder.
2. Rename the File: Right-click on the file and choose "Rename."
3. Change the Extension: Carefully change the file extension from .twbx to .zip. For example, change Sales_Dashboard_Q3.twbx to Sales_Dashboard_Q3.zip.
4. Confirm the Change: Your operating system will likely show a warning that changing a file extension can make it unusable. That’s okay in this case. Go ahead and confirm the change (click "Yes" on Windows or "Use .zip" on Mac).
5. Extract the Zip File: The icon should now look like a standard zip archive. Now, just unpackage it like any other zip file:
6. Explore the Contents: A new folder will be created. Inside, you'll find the same structure as with Method 1: the main .twb file and folders named "Data," "Images," etc., containing all the source assets.

One bonus of this method is that it can work even if you don't have Tableau Desktop installed, or if the workbook is corrupted and won't open in Tableau, allowing you a last-ditch effort to recover the raw data.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

What's Inside Your Unpackaged Workbook?

So, you've successfully unpackaged the workbook. What exactly are you looking at? The folder structure is simple and logical.

The .twb File

This is the primary file and the "brain" of your visualization. If you were to open this file, you wouldn't see any data unless the original data source is still located where the .twb file expects it to be (which, after unpackaging, is now the new "Data" folder).

The "Data" Folder

This is where you'll find the goodies! Inside this folder, Tableau stores a local copy of any non-server-based data sources. This may include:

• .xlsx or .xls files from Microsoft Excel.
• .csv files (Comma Separated Values).
• .txt files (Tab-Delimited text files).
• .hyper or .tde files (Tableau Data Extracts).
• Microsoft Access files (.mdb).
• Spatial files like .shp (Shapefiles).

The "Images" Folder

If the original workbook used any logos, custom background images, or other picture files that were imported into the dashboard (not hosted on a URL), they will appear here. This is a quick way to grab a company logo or specific infographic asset from a dashboard.

Common Problems and Quick Solutions

Unpackaging is usually a seamless process, but here are a couple of small hiccups you might encounter.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Problem: I can't see the file extension (.twbx) to change it!

Solution: Your operating system is likely hiding file extensions by default.

• On Windows 10/11: Open File Explorer, click the "View" tab at the top, and check the box that says "File name extensions."
• On macOS: Open Finder, click "Finder" in the menu bar, go to "Preferences," click on the "Advanced" tab, and check the box for "Show all filename extensions."

Problem: After unpackaging, my workbook won't load the data.

Solution: When you unpackage a workbook, the new .twb file changes its data source reference to look for the data files inside the newly created "Data" folder. If you move either the .twb file or the "Data" folder, the connection path will break. To fix this, open the .twb file in Tableau, and it will prompt you to locate the data source. Simply navigate to the file in the "Data" folder to re-establish the connection.

Final Thoughts

Knowing how to unpackage a Tableau workbook provides a simple but powerful way to get under the hood of your visualizations. Whether you are using Tableau's built-in feature or the clever zip renaming trick, this skill is excellent for accessing data, grabbing visual assets, and gaining more flexible command over your analytics projects.

Instead of manually packaging reports and sending static files back and forth, modern teams often need a more dynamic way to access insights. Here at Graphed, we automate the entire reporting process so your data is always live and accessible. We make it easy to connect directly to sources like Google Analytics, Shopify, and Salesforce. From there, you just ask questions in plain English to instantly build real-time dashboards and reports, empowering your entire team to get the insights they need without the friction of downloading, unpackaging, and managing files.