How to Send Tableau Workbook with Data

Sending a Tableau workbook to a colleague only to get the dreaded reply, "Why is your dashboard blank?" is a frustratingly common experience. You built a beautiful, insightful visualization, but when they open the file, all your hard work is replaced with empty charts and error messages. This article will show you exactly how to send a Tableau workbook with all its data, ensuring anyone can view and interact with your analysis just as you intended.

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

Why Your Tableau Workbook is Blank for Others

This problem almost always comes down to the file type you’re sending. Tableau has two primary workbook file types, and understanding the difference is the most important step in successfully sharing your work.

Think of it like sharing a Google Doc. When you share the link, you're sharing the document itself, and anyone with the link can see the content. But if you were to somehow just send the URL's text, your recipient would just have a web address with no content.

Tableau workbooks function similarly. The issue occurs when you send the instructions (your dashboard design) without the raw materials (your data). Let's break down the two file types to clear this up for good.

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

.TWB (Tableau Workbook): The Recipe Card

A .twb file is the standard Tableau Workbook format. It’s an XML file that contains all the information about your dashboards, worksheets, calculated fields, formatting, and layout. In short, it holds all of your design and analysis choices.

What it doesn't contain is the data itself. A .twb file only contains a reference or a link to your original data source. When you open a .twb file, Tableau follows that link to load the data. If you're on your own computer and connected to that data source (like a local Excel file or a a company database), everything works perfectly.

But when you email that .twb file to a coworker, their computer doesn't have the same link to your original data source. Tableau tries to follow the path, finds nothing, and displays a blank dashboard.

A .twb file is essentially a recipe: it tells Tableau what ingredients to use and how to arrange them, but it doesn't provide the ingredients themselves.

.TWBX (Tableau Packaged Workbook): The Complete Meal Kit

A .twbx file is what you need for sharing. It's a "packaged" workbook, which is a lot like a zip file. It bundles your original .twb workbook file along with a copy of the data source itself. This copy could be from a data extract, a local CSV or Excel file, or even custom images and background maps you’ve used.

When someone opens a .twbx file, Tableau finds everything it needs right inside that single file. It doesn't have to look for an external data source because the data is already packaged inside.

A .twbx file is the complete meal kit: it contains both the recipe card (the .twb) and all the necessary ingredients (the data and other assets). This is the file type you should almost always use when sending a workbook to someone else.

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

Step 1: Create a Tableau Data Extract (.hyper)

Before you can save your workbook as a packaged .twbx, you often need to create a data extract first. An extract is a highly compressed snapshot of your data that is stored locally and optimized for performance in Tableau.

Creating an extract is necessary when you are connected to a live database (like SQL Server, Redshift, or Salesforce). If you're already using a local file like a CSV or Excel spreadsheet, Tableau can often package that directly, but creating an extract is still a best practice for performance and for ensuring the data is self-contained.

How to Create an Extract

Follow these quick steps to convert your live connection to an extract:

1. Navigate to the Data Source Tab: Go to the "Data Source" page in the bottom-left corner of your Tableau Desktop window.
2. Select 'Extract': In the top-right corner of the pane, you’ll see options for 'Live' and 'Extract'. Click on Extract.
3. Initiate the Extract Creation: Now, click on any sheet tab at the bottom of the window (e.g., "Sheet 1"). Tableau will realize you've switched to an extract and prompt you to save it.
4. Save the Extract File: A dialogue box will appear asking you where to save the data extract. This file will have a .hyper extension. Name it and click 'Save'. Tableau will then process your data and create the optimized extract.

Your workbook is now using this local, self-contained snapshot of the data. This prepares it perfectly for being packaged up and shared.

Step 2: Save as a Tableau Packaged Workbook (.TWBX)

With your data connections pointing to extracts (or local files), you're now ready for the final step: saving the workbook as a .twbx file.

The Primary Method: Use "Save As"

This is the most straightforward method for creating your shareable file.

1. Go to the File Menu: In Tableau Desktop, click File in the top menu bar.
2. Choose 'Save As': From the dropdown menu, select Save As….
3. Change the File Type: A save dialogue box will appear. At the bottom, look for the "Save as type" dropdown menu. Click on it and select Tableau Packaged Workbook (*.twbx).
4. Name and Save Your File: Choose a name for your packaged workbook and click 'Save'.

That's it! You now have a single .twbx file containing your dashboard and all its underlying data. This is the file you can confidently attach to an email, upload to a shared drive, or send through Slack.

Graphed

Still Building Reports Manually?

Watch how growth teams are getting answers in seconds — not days.

Watch the Demo

Alternative Method: Exporting a Packaged Workbook

Sometimes you may want to keep your original file as a .twb (perhaps because it's connected to a live database you regularly refresh) but still need to send a one-off packaged version to someone.

In this case, you can use the export feature:

1. From your open workbook, navigate to File > Export Packaged Workbook…
2. Tableau will process the workbook and its data sources.
3. A dialogue box will appear where you can name and save the new .twbx file.

This method accomplishes the same goal as "Save As," but allows you to create a distributable .twbx file without changing the format of your original working file.

Best Practices for Sharing Workbooks

Creating a .twbx solves the main technical problem, but follow these tips to make the sharing process smoother for everyone involved.

• Keep an Eye on File Size: Since a .twbx contains the data, its file size can get very large, very quickly. A workbook built on millions of rows of data could result in a multi-gigabyte file that you can’t email. Before creating your extract, use Data Source filters in Tableau to remove any data that isn't necessary for your dashboard.
• Clean Up Your Workbook: Hide any unused worksheets before you save the packaged workbook. This prevents the end-user from getting confused by messy "scratchpad" sheets you used for development. Right-click the tab for a sheet you want to hide and select 'Hide Sheet'.
• Check for Version Compatibility: Tableau is not backward compatible. This means a workbook created in a newer version of Tableau Desktop (e.g., 2023.2) cannot be opened by someone using an older version (e.g., 2022.1). Ask your recipient which version they have. If needed, you can export your workbook for an older version by going to File > Export as Version….
• Point Them to Tableau Reader: What if your stakeholder doesn't have a paid Tableau Desktop license? They can use Tableau Reader, a free desktop application for viewing and interacting with existing dashboards. Let them know they can download it for free to open, filter, and explore the .twbx file you send them.

Final Thoughts

Mastering the difference between a .twb and .twbx is a rite of passage for every Tableau user. By packaging your workbooks, you ensure your masterpiece arrives with its data included, solving the blank dashboard mystery and making your analysis easily accessible to your team and stakeholders.

While packaging workbooks is the classic way to share analyses, constantly emailing static files creates version control headaches and silos of stale data. That's why we built Graphed to remove this friction entirely. Instead of packaging and sending files, we let you connect data sources like Google Analytics, Shopify, and Salesforce directly and build shareable, real-time dashboards with simple natural language. Team members can securely view live insights in their browser, eliminating the need for desktop software or worrying about who has the most up-to-date file.