How to Send a Tableau Packaged Workbook

Need to share a Tableau dashboard with someone who can't connect directly to your data? Sending them a regular workbook won't cut it. The solution you're looking for is a Tableau Packaged Workbook, and creating one is easier than you think. This article will show you exactly what a packaged workbook is, when to use one, and the step-by-step process for creating and sending it.

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 is a Tableau Packaged Workbook (.twbx)?

To understand what a packaged workbook is, it's helpful to first understand what a standard Tableau Workbook (.twb) is. Think of it like a recipe: it contains all the instructions for creating your visual - your sheets, dashboards, formatting rules, calculated fields, and the connection information for your data source - but it doesn't contain the actual ingredients (the data itself).

If you send a .twb file to a colleague who doesn't have access to the same database or network location where the source data (like an Excel file) is stored, they'll just see an error message. The workbook can't find its ingredients.

A Tableau Packaged Workbook (.twbx) solves this problem. It’s essentially a zip file that bundles everything together:

• The original workbook (the .twb file).
• A copy of the local data source (like a CSV, an Excel file, or a Tableau Data Extract).
• Any custom images, shapes, or geocoding you've used in the dashboard.

By packaging everything into a single .twbx file, you create a self-contained report that anyone with Tableau Desktop or Tableau Reader can open and view, regardless of their access to the original data source.

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

When Should You Use a Packaged Workbook?

Packaged workbooks are incredibly useful in several common scenarios. Here’s when you'll most likely need one:

• Sharing with external stakeholders: If you're sending a report to a client, partner, or colleague outside your organization, they won't have access to your live databases. A .twbx is the perfect way to give them an interactive snapshot.
• Presenting offline: When you need to present your dashboard and can't risk a spotty internet connection, a packaged workbook ensures your data and visuals are available locally on your machine.
• Archiving reports: If you need to save a point-in-time report (like for an end-of-quarter analysis), a .twbx file captures the exact state of the data at that moment. The data is static and won't change, which is perfect for historical records.
• Building a portfolio: When including your work in a data visualization portfolio, a packaged workbook allows potential employers or clients to see and interact with your dashboard without needing any special connections.
• Seeking help from the Tableau community: If you're asking for troubleshooting help on forums, you'll almost always be asked to provide a packaged workbook so others can see your data structure and calculations.

How to Create a Tableau Packaged Workbook

Creating a .twbx file is a straightforward process built directly into Tableau Desktop. Just follow these simple steps.

1. Open Your Workbook: Start with your finished or nearly finished workbook open in Tableau Desktop.
2. Navigate to the File Menu: In the top menu bar, click on File.
3. Select "Export Packaged Workbook..." From the dropdown menu, choose the option Export Packaged Workbook...
4. Save the File: A "save" dialog box will appear. Choose the folder where you want to save your file, give it a clear and descriptive name, and click Save. The file type will default to .twbx.

That's it! Tableau will gather your workbook, data, and any local files and package them into a single .twbx file in the location you selected. You can easily verify it worked by looking at the file's extension and its file size - it will be significantly larger than your original .twb file.

Best Practices: What to Check Before You Send

Before you attach that file to an email, run through this quick checklist to ensure a smooth handoff and avoid common pitfalls.

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

1. Check Your Data Connection Type

Packaged workbooks work best with file-based data sources like Excel, CSV, and text files. If your workbook is connected to a live server-based data source (like Microsoft SQL Server, Snowflake, or Redshift), Tableau can't "package" the entire server. Instead, it will prompt you to create a Tableau Data Extract (.hyper file) first.

An extract is a highly compressed snapshot of your data stored locally. To create one manually:

• In the Data pane on the left, right-click on your data source.
• Select Extract Data...
• Follow the prompts to configure and save your extract.

Once the extract is created, you can proceed with exporting the packaged workbook, and Tableau will bundle the extract along with it.

2. Be Mindful of Data Sensitivity

Remember, a .twbx contains an actual copy of the data. Anyone who opens the workbook can potentially see and export the underlying raw data. Before sending, make sure you are not sharing any private, sensitive, or proprietary information.

3. Clean Up Your Workbook

A tidy workbook is easier for others to understand. Consider these small cleanup tasks:

• Hide Unused Fields: In the Data pane, click the small down arrow and select "Hide All Unused Fields." This removes clutter and makes it easier for the recipient to see which data is relevant.
• Clear Out Hidden Sheets: Make sure you're not sending over draft worksheets or hidden dashboards with old information. Right-click on any sheet tab to see options for hiding or unhiding them.

4. Ask About Tableau Version Compatibility

This is the most common reason a workbook can't be opened. A packaged 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). If possible, ask your recipient what version they are using.

If they have an older version, you can export your work for them by going to File > Export As Version... and choosing their version from the list.

How to Send Your Packaged Workbook

Once you have your clean and vetted .twbx file, here are the most common ways to send it:

• Email: If the file size is under 20-25MB, you can typically attach it directly to an email without any issues.
• Cloud Storage: For larger files, services like Google Drive, Dropbox, or WeTransfer are your best bet. Simply upload the file to your cloud storage provider and share the link with your recipient.
• Company Messengers: Tools like Slack or Microsoft Teams handle file transfers well and can be a fast way to share workbooks with internal team members.
• Zip it Up: While .twbx is already a compressed format, zipping the file can sometimes trim the file size down a little further and helps prevent rare issues with email filters that might accidentally block unfamiliar file extensions.

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

Troubleshooting Common Problems

Even with careful preparation, you might run into an occasional issue. Here are the most common ones and how to fix them.

Problem: "My recipient can't open the workbook."

• Cause: 99% of the time, this is a version incompatibility issue. You saved it in a newer version of Tableau than they are using.
• Solution: Ask for their Tableau version and use File > Export As Version... to save a compatible copy.

Problem: "The file is too large to send."

• Cause: The data extract is massive. This can happen with very granular or large datasets.
• Solution 1: Remove Unused Columns. Before creating your extract, hide all unused columns. The extract will only include the fields necessary for your view, drastically reducing its size.
• Solution 2: Filter the Data. Apply filters to your extract to only include the data you absolutely need. For instance, if your dashboard only shows the last 12 months, filter the extract to match.
• Solution 3: Aggregate the Data. When creating the extract, choose "Aggregate data for visible dimensions." This rolls up the data to the level of detail displayed, which can make the file much smaller, though you lose the ability to drill down to the row level.

Final Thoughts

Making a Tableau Packaged Workbook is a fundamental skill for sharing your data stories effectively. It’s the standard method for creating a self-contained, interactive dashboard that anyone can open without needing a connection to your live data. Mastering this process ensures your insights can reach your intended audience, worry-free.

Of course, the need for packaging and emailing reports often highlights a broader challenge: keeping everyone in sync with live data is hard. At Graphed we created a way to skip exporting files altogether. We connect directly to your marketing and sales platforms (like Google Analytics, Shopify, Facebook Ads, or HubSpot) and let you build real-time, shareable dashboards just by asking questions in plain English. Instead of sending static files, you can share a live link where the data is always up-to-date, making the entire reporting process faster for you and more valuable for your team.