How to Send a Tableau File via Email

Sending a Tableau file to a colleague or client should be as simple as attaching it to an email, but it often leads to a frustrating response: "The workbook is blank." This classic issue happens for a specific reason, and thankfully, it has a simple fix. We’ll walk you through exactly how to prepare and send your Tableau files so they open perfectly every time.

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

Why You Can't Just Email a Standard Tableau Workbook (.twb)

When you start a project in Tableau, the default file type is a Tableau Workbook, which has a .twb extension. It’s easy to assume this is the file you should share, but it almost never works as an email attachment.

Think of a .twb file like a recipe card. It contains all the instructions for your masterpiece: which charts to build, what colors to use, how your dashboards are formatted, and what fields go into your rows and columns. However, it does not contain the ingredients — the actual data.

Instead, the .twb file points to a data source located on your computer, a network drive, or a cloud server. When your colleague tries to open your .twb file, Tableau follows the "recipe" but can't find the "ingredients" on their machine. All they see are blank worksheets and error messages because they don’t have access to your original data path.

**Analogy:** Sharing a .twb file is like emailing someone a document with shortcuts to files on your personal desktop. When they click the shortcuts, nothing happens because those files don't exist on their computer.

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

The Solution: The Tableau Packaged Workbook (.twbx)

To share your work successfully, you need to use a Tableau Packaged Workbook, which has a .twbx extension. This file format is designed specifically for sharing.

A .twbx file is a self-contained package — essentially a zip file that bundles four key components together:

• The original workbook (.twb): The recipe card with all your visualization instructions.
• The data source(s): A copy of the "ingredients" such as an Excel file, a CSV, or a Tableau data extract (.hyper).
• Custom images: Any background pictures or logos you've used in your dashboards.
• Custom shapes: Any custom shape files you've added to the workbook.

By saving your work as a .twbx, you create a portable version that anyone with Tableau Desktop or the free Tableau Reader can open and view exactly as you intended, with all the data and formatting included.

How to Create and Send a Tableau Packaged Workbook (.twbx)

Creating a packaged workbook is straightforward. Follow these steps to ensure a flawless sending process.

Step 1: Save as a Packaged Workbook (.twbx)

First, make sure your visualization is exactly how you want to share it. Then, instead of just hitting "Save," follow this path:

1. Open your completed workbook in Tableau Desktop.
2. In the top menu, navigate to File > Export Packaged Workbook....
3. A dialog box will appear asking you where you'd like to save the file. Choose your desired location (like your Desktop or a specific project folder).
4. Give the file a clear name, such as "Q3-Marketing-Performance-Report.twbx," and click Save.

That's it! You now have a .twbx file ready for sharing.

Step 2: Check the File Size Before You Send

One potential roadblock is the file size. Because a .twbx contains a copy of your data, it can quickly become too large for email. Most email services, like Gmail and Outlook, have attachment limits around 25 MB.

Before attaching anything, find the file you just saved and check its size. Right-click on the file and select "Properties" (on Windows) or "Get Info" (on Mac).

• If the file is under 25 MB: You're good to go! Attach it directly to your email.
• If the file is over 25 MB: Attaching it will likely fail. You'll need to use a different method, which we cover in the next step.

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

Step 3: What to Do with Large Tableau Files

If your .twbx file is too large to email, you have a couple of excellent options to reduce its size or share it another way.

Option 1: Compress or Filter Your Data Extract

The biggest factor driving up file size is the data itself. If you're using a data extract, you can often shrink the file by removing data that isn't necessary for the visualization.

• Apply Filters to the Extract: Go to your Data Source tab. In the top right corner, click on "Edit" next to your extract connection. From there, you can add filters. For example, if your dashboards only show data from the last 90 days, you can add a date filter to the extract itself to exclude an unnecessary decade of historical data.
• Aggregate Data: You can also choose to aggregate the data to a higher level. For example, rolling up daily data to weekly or monthly level will massively reduce the number of rows included.

After applying these changes, go through the "Export Packaged Workbook" steps again. You'll likely see a massive reduction in file size.

Option 2: Use a Cloud Sharing Service

The simplest way to bypass email size limits is to use a file-sharing service. It's fast, secure, and what most professionals do for large files.

1. Upload your .twbx file to a service like Google Drive, Dropbox, WeTransfer, or OneDrive.
2. Once uploaded, generate a shareable link.
3. When sharing, make sure to set the permissions correctly so your recipient can access it (e.g., "Anyone with the link can view").
4. Paste this link into your email instead of attaching the file directly.

Step 4: Compose the Email with Key Information

When you're ready to hit "send," include this important detail in your email: the version of Tableau Desktop you used to create the workbook.

Tableau isn't always backward compatible, meaning a workbook saved in a newer version (like 2023.3) cannot be opened by someone running an older version (like 2022.1). A quick postscript can save hours of confusion.

Here's a sample message:

"Hi team,

Here is the packaged workbook for the Q3 campaign review. You can download it using the link below.

Let me know if you have any questions.

P.S. I created this using Tableau Desktop version 2023.3, so you'll need that version or newer to open it."

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

Critical Information for Your Recipient

To view your .twbx file, the recipient needs one of two applications installed:

1. Tableau Desktop: If they're a fellow analyst or creator, they likely have this already.
2. Tableau Reader: If the recipient only needs to view and interact with the dashboard (filter, click, and sort), they can use Tableau Reader. It's a free application that can open .twbx files but cannot edit them. This is the perfect solution for VPs, stakeholders, or clients who don't need a full Tableau license.

It's helpful to include a link to the Tableau Reader download page in your email for any non-technical recipients.

Troubleshooting Common Issues

If you or your recipient run into problems, here are a few common causes and their fixes.

• Problem: "The workbook is blank." Cause: You sent a .twb file instead of a .twbx. Fix: Go back to Tableau, click File > Export Packaged Workbook... and send the resulting .twbx file instead.
• Problem: "An error occurred while communicating with the data source." Cause: This can also be a symptom of sending a .twb using a live database connection. Fix: Create an extract of your data before exporting the packaged workbook. In the Data Source tab, switch your connection from "Live" to "Extract." Then save your .twbx.
• Problem: "This workbook was created in a newer version of Tableau." Cause: You saved the file in a more recent Tableau version than what the recipient has installed. Fix: You can export an older version. In Tableau Desktop, go to File > Export as Version... and select an older version that matches your colleague's. Note that any features exclusive to your newer version may be lost in the conversion.

Final Thoughts

Sharing your work in Tableau is incredibly powerful - when it's done right. Remembering to export as a Packaged Workbook (.twbx) is the single most important step. This small habit ensures your data story is seen exactly as you designed it, letting you focus on the insights instead of the tech issues. Be mindful of file sizes and version compatibility, and your sharing process will be smooth and professional every time.

While emailing Tableau files is reliable for static, one-off reports, keeping collaborators in sync with live data presents its own set of challenges. At our company, we streamlined this process by using Graphed. We connect our data sources once and use plain English to build real-time, instantly shareable dashboards. Instead of worrying about who has the latest .twbx file, our team simply shares a link to a live report, ensuring everyone always sees the most current data without manual updates.