What is the TWBX file format?
A .twbx file contains a compressed data package used by Tableau for sharing workbooks. .TWBX is a complete workbook resource package that can contain:
- A
.TWBXML workbook file - Bundled data extracts:
.hyperfiles (current) or legacy.TDEfiles - External data from MS Access, MS Excel, and text files such as
.CSVand.TXT - Image files (usable as background images)
- Custom geocode files and custom shape files
Workbook files hold references to the other files in the .twbx package. This makes .twbx workbooks different from standard workbooks, which hold references to external, dynamic resources for source data.
Uses of .twbx files
.twbx files are used for sharing workbooks along with their associated source data, to avoid situations where the workbook recipient doesn't have access to the files or data referred to in the workbook. .twbx workbooks are typically used for generating reports for a specific time period. Data in .twbx workbooks is not updated automatically as the source data changes. .twbx files can be shared on Tableau Server or Tableau Cloud, posted to Tableau Public, or sent via e-mail.
Creating and opening workbook packages
.twbx files are created in Tableau Desktop via File → Export Packaged Workbook, which bundles a .twb workbook with its data extract (a .hyper file in modern Tableau, or a .tde in older versions). Tableau Reader (free) opens .twbx files on Windows and macOS. Because .twbx is built on a standard ZIP archive format, tools such as 7-Zip can extract its contents directly - renaming the file to .zip works too. Source data is stored in a Data/ subfolder accessible by extracting the .twbx file. The inner .twb workbook is plain XML and can be inspected in any text editor.
Security & safety
RISK: LOWA .twbx is data plus a visualization layout, not executable code, so opening one is low-risk. Two cautions worth noting: a packaged workbook can EMBED the source data (and sometimes database credentials) - be careful before publishing one to Tableau Public, which makes the workbook and its bundled data publicly downloadable; and only open .twbx files from trusted senders, since the bundled data is exposed to whoever opens the file. The container itself does not run macros or code.
Format details
in a nutshellPrograms that open TWBX files
Windows3 apps
Tableau Desktop
Paid File > Open the .twbx; the workbook and its packaged data load together for full viewing and editing. 
7-Zip
Open-source Right-click > 7-Zip > Open archive to inspect the .twb XML and Data/ extract (it's a ZIP); does not render the dashboard. 
Tableau Reader
Free Open the .twbx to view and INTERACT (filter, sort, hover) with the dashboards - free, no Tableau license needed; cannot edit structure. 
macOS2 apps
Tableau Public
Free Upload/open a .twbx in Tableau Public (desktop app or web) to publish and view the dashboard in a browser. Note: Public makes the workbook publicly visible.
Tableau Cloud / Server
Paid Publish the .twbx to your organization's Tableau site to view it in the browser (requires a licensed site). Technical details
deep spec| Container format | Standard ZIP archive; magic bytes `50 4B 03 04` ("PK" header) at offset 0 - identical to any `.zip` file |
| Inner workbook format | `.twb` XML file (UTF-8 encoded) placed at the archive root; defines all sheets, dashboards, and data source connections |
| Data extract format | `.hyper` (Hyper engine, current standard) or legacy `.tde` (Tableau Data Engine) files stored in the `Data/` subfolder |
| Compression | DEFLATE applied per-entry via standard ZIP; each bundled file is compressed independently |
| Internal folder structure | `Data/` subfolder holds `.hyper`/`.tde` extracts plus any image and custom-shape assets referenced by the workbook |
| Encoding | Binary ZIP container overall; the inner `.twb` workbook is UTF-8 XML text |
| MIME type | `application/octet-stream` (registered); also recognized as `application/zip` by generic ZIP handlers |
| Version tracking | Tableau version number stored in the `.twb` root element's `version` attribute (e.g., `version='2024.3'`) |
| Forward compatibility | A `.twbx` saved in a newer Tableau Desktop version cannot be opened in an older version; Tableau will refuse and report the version mismatch |
| Integrity | Per-entry CRC-32 checksums provided by the ZIP format; no whole-file cryptographic signature or hash |
| Typical file size | Hundreds of KB to several GB, driven primarily by the size of the bundled `.hyper` data extract |
| Encryption | None at the file level by default; Tableau Server and Tableau Cloud enforce access control externally |
| Platform support | Windows and macOS (Tableau Desktop, Tableau Reader); web browser via Tableau Public and Tableau Cloud upload |
| Primary purpose | Self-contained portable snapshot - bundles workbook logic with its data so recipients need no access to the original database or files |
| Developer | Tableau Software, a Salesforce company |
| Released | 2003 (Tableau Desktop; packaged-workbook format matured over later releases) |
| Latest version | Tracks the current Tableau Desktop file version; .twbx layout is stable (ZIP container) |
| Specification | help.tableau.com |
TWBX conversions
Community Q&A
asked by usersNo questions yet - be the first to ask about TWBX files.
