Tableau

The Tableau connector lets you connect to Tableau in Designer.

Tableau is available as a data source in the Input Data and Output Data tool, and as the standalone Tableau Input and Tableau Output tools.

New Connector Version in Designer

The Tableau connector is now part of the Alteryx One connectors experience. Review the information on this page carefully to ensure you're using the appropriate tools correctly.

If you want to update the Tableau connector in your Designer workflows, you can use the workflow migration utility.

Tableau Connector Setup

Tableau is available in Designer 2025.1 Patch 5 or later and 2025.2 Patch 3 or later as a data source for the Input Data and Output Data tool. To learn more about the tools, see Input and Output Tools.

Prerequisites

Ensure you have completed the following prerequisites before proceeding:

Requirement	Detail
Designer version	Designer 2026.1+ (required for unified connector and also required specifically for Output options like Hyper file version and database schema selection)
Tableau Server version	Tableau Server 2023.3+, using Tableau REST API 3.21
AMP	Must be enabled
DCM	You must enable DCM in Designer. Go to Options > Advanced Settings > DCM to enable it
Tableau deployment type	Tableau Server (self-hosted, on-prem or private cloud) using your server URL

Install the Connector

You can easily install the latest version of the Tableau connector from Designer via the Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.

To install the connector...

In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.
Select Tableau Tools and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.
After installation and setup are complete, the Tableau connector is available from the Input Data and Output Data tools.

Set Up a Connection

To connect to Tableau using DCM...DCM - Designer

Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.
In the Connector Setup, select Create or Browse a Data Connection.
If you've created a Tableau connection before, you can select the connection from the Recents tab.
Select + New. From the list of technologies, select Tableau.
Select Setup Connection. The Connections window opens.
Select +New.
Specify the connection name, data source name, and the server URL.
In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.
Select Save.
Select Connect. Tableau may request authentication.
Select the file to read from or write to in the file browser window.
Select the read or write configuration in the Options window.
Select Confirm to create a connection to the file. You can continue building your workflow.

Tableau Connector Release Notes

Connector Release Version 2.2.0
Version	Description
v2.2.0	Added support for testing Tableau connections in DCM. Added Tableau Cloud support for Input and Output tools, with Site required for Tableau Cloud connections.
v2.1.0	Available in Designer 2026.1+, Tableau Server 2023.3+ (Tableau REST API 3.21). Requires AMP and DCM. Input reads a single-table datasource with typed columns. Output supports Hyper file versions V1 through V4, multiple database schemas, Write to a single table with a name of your choice. Append and Overwrite are API-based. Fixed an issue where migration incorrectly attempted a credential refresh for connections without an OAuth token (Tableau uses PAT or username and password).
v2.0.1	Input and Output (single table). Output added API-based Append, manual and dynamic project paths, Hyper V2, fuzzy search for projects and datasources, and automatic chunking of large writes. Fixed an issue where large writes failed with an error. Fixed an issue where ew datasources were not created with a timestamp appended to the name. Fixed project and datasource browsing pagination, search, and navigation issues.

Input and Output Tools

The Tableau Input and Output tools are used to read from and write to Tableau.

Tableau Input

Tableau Input reads data from a published Tableau data source.

Authenticate through a DCM Tableau connection.
Browse sites and projects in a tree, with pagination and fuzzy search, or enter a path.
Select a single-table datasource to read.
Columns are returned as typed data (for example, Date and DateTime are read as date and datetime types).

Tableau Output

Tableau Output writes data to Tableau and publishes it as a datasource (a Hyper extract). This tool supersedes the older Publish to Tableau Server tool.

Authenticate through a DCM Tableau connection.
Choose or define the destination: browse to a project and datasource, or enter the project path and datasource name (including dynamic paths driven by fields or parameters).
Write to a single table with a name of your choice.
Choose the action when the datasource already exists: create a new datasource, rename and create, overwrite the existing datasource (preserves the datasource ID and creates a new version), or append rows to the existing datasource. Append and Overwrite are performed through the Tableau API.
Select the Hyper file version (V1 through V4) and the database schema (for example, public or Extract). These options require Designer 2026.1+.

Object Model

Understanding the Tableau hierarchy helps you configure the tools correctly:

Site: Organizations often use separate sites per business unit or environment. Each site has its own users, projects, workbooks, and datasources.
Project: Used to organize content. Projects can be nested.
Workbook: Contains one or more sheets (visualizations, dashboards, stories) and uses datasources for its underlying data.
Datasource: The connection to data that workbooks use. It can be a live connection or an extract. A datasource exposes one or more tables.
Table: A structured dataset inside a datasource. When Alteryx publishes to Tableau, it writes into a table within a datasource, stored as a .hyper extract.

Authentication Methods

The unified connector authenticates through DCM. Tableau supports three authentication methods. Use the table below to choose the right one for your use case.

Method	Desktop	Cloud (Alteryx One)
Personal Access Token (PAT)	Yes	No
Tableau Server username and password	Yes	No
Tableau Connection Manager (TCM)	No	No

Note

Tableau Server (self-hosted, on-premises, or private cloud) connects using your server URL, and supports either a Personal Access Token (PAT) or a Tableau Server username and password as credentials.
Tableau Cloud (SaaS, hosted by Tableau) uses a site-specific URL of the form https://<site>.online.tableau.com. Tableau Cloud support for the unified connector is in progress and not yet available.

Migration to Unified Tableau

If you already use the Tableau connector in Alteryx, read the section below. It walks through what has been changed in the unified version.

Parameter	Legacy Connector (Python SDK)	Unified Connector
Platforms and Tools	Desktop (Input and Output)	Desktop (Input and Output) at GA Cloud in progress
Framework	Python SDK	Unified connector framework
Communication / API	Legacy Tableau REST API	Tableau REST API 3.21 (requires Tableau Server 2023.3+)
Authentication	Legacy authentication	Personal Access Token (PAT) or Tableau Server username and password
Connection model	Tool-level / non-DCM	DCM

Existing workflows can be migrated using the Alteryx Workflow Migration Utility in Designer 2025.1 Patch 5 or later. However, it is only available on desktop. For more information, see workflow migration utility.

Limitations

Date and DateTime values now show trailing zeros on read (extra microsecond digits). To restore the previous formatting, add a Select or Sample tool downstream to trim the extra zeros.
Tableau Output cannot publish a datasource from a fixed-decimal field that was read from a local .hyper file. Convert the field to a Double (for example with a Select tool) before the Tableau Output tool. This also helps avoid conflicts during later Append or Overwrite operations on the same datasource.
Update, Upsert, and Upload Hyper File operations are no longer supported. If your workflow relies on Update or Upsert, redesign it to use Overwrite (to replace a datasource) or Append (to add rows).
The connector now supports only single-table datasources. You write to a single table with a name of your choice, and .tds file support has been removed as a result. If your workflow uses multi-table datasources, redesign it to publish to a single-table datasource instead.
You can't create new or nested projects directly from the connector. Create the project in Tableau first, then browse to it or enter its path in the tool.
The tool does not list the tables inside a datasource for you to pick from. Enter the table name manually instead.
Non-DCM connection methods have been removed, so all connections must be created through DCM, authenticated with a PAT or a Tableau Server username and password.
Tableau Connection Manager (TCM) is not supported on either Input or Output. Use a PAT or a Tableau Server username and password instead.
The Attach Metadata and Enable Dry Run options aren't available for Tableau Input on the unified-connector framework, on Desktop.
The connector requires Designer 2026.1+ and Tableau Server 2023.3+ (Tableau REST API 3.21) for both Input and Output. Advanced options like Hyper file version and database schema selection also require Designer 2026.1+.
Currently, the connector is available on Desktop (Flagship) only, for both Input and Output. Cloud support is in progress with no confirmed date. Once Cloud ships, expect the migration utility to remain unavailable there, local download to stay Desktop-only, the connection-creation flow to differ (built-in connection creation will not be available), and supported formats and produced datatypes to potentially differ from Desktop.

Tableau Standalone Connector Versions 1.5.7 and Earlier (Deprecated)

The standalone Tableau tools have been deprecated. Install the latest Tableau connector to leverage the newest features.

July 18, 2026

Tableau Version 1.5.7

Tableau Version 1.5.7 and Earlier
ID	Description
v1.5.7	Fixed issue where Tableau Output failed to append on Overwrite/Append when using `.tds` for Data Source Metainfo. Known Issues Tableau Connector v1.5.5 Gallery authentication failures.
v1.5.6	Fixed DCM connection handling issue. Fixed an issue where Tableau Output tool failed to connect to Tableau Server with `Invalid CORS request` / `Credentials Denied` post upgrade to 2025.2 from 2024.2. Fixed issue where workflow with multiple Tableau output tools and multiple DCM connections published to wrong Tableau server. Known Issues Tableau Output fails to append on Overwrite/Append when using `.tds` for Data Source Metainfo.
v1.5.5	The Tableau tools now support reading multiple tables. The Tableau connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow. We disabled the right-click context menu in Designer for the Tableau tools to prevent unintended actions. Fixed an issue where the Tableau Output tool did not escape backslashes for UNC paths when uploading HYPER files. Fixed an issue where Tableau Output tool did not reset the table name to the default when it starts with “table”. Fixed an issue where the Tableau Output tool returened this `error: Could not init plugin AttributeError("'NoneType' object has no attribute 'split'")`. Fixed an issue where the Tableau Output tool returned an error when numeric values are 0 during update or upsert operations. Fixed an issue where resetting the table name when the project or data source changes caused an error if the name is duplicated in the Tableau Output tool. Fixed an issue where special characters in the proxy password caused an error when setting up a manual proxy server for the Tableau tools. Fixed an issue where the Tableau tools added proxy credentials to the manual proxy settings even when the proxy does not require them. Fixed an issue where the Tableau Output tool returned a `Datatype conversion failed` error when spatial fields contain null values.
v1.5.4	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. Alteryx Server requires stored credentials in DCM to run workflows. The Tableau connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow. Fixed issues where the DCM connection returned these errors: 'NoneType' object has no attribute 'get' Failed to process selected datasource <DATASOURCE> Failed to sign in to Tableau serverUrl Fixed issue where uploading a HYPER file fails with <class 'KeyError'>: '#1' and list out of index range. Fixed issue where the Tableau tools returned the temp_table error. Known Issues Special characters in proxy password cause errors in manual proxy server setup. Using getIpAddress() in a PAC file returns the local IP Address in PyPAC. (TPM-4515)
v1.5.3	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. Alteryx Server requires stored credentials in DCM to run workflows. Added the connection ID to the results window when using DCM. Fixed issue where the Tableau tools published data to the wrong project ID when filtering by favorite. Fixed issue where the DCM connection handling rule wasn’t applied to the Tableau tools. Fixed issue where the parent project name wasn’t displayed in the Select Project configuration. Fixed issue where Tableau Output didn’t write SpatialObj data correctly. Fixed issue where the Tableau tools ignored the NO_PROXY variable if the HTTP_PROXY or HTTPS_PROXY variables were used. Fixed issue where Tableau Output didn’t adhere to proxy exceptions in LAN settings. Known Issues Tableau Output fails to write data to Tableau Cloud. Designer returns this error message: `unknown table 'temp_table' Context: 0xfa6b0e2f.`
v1.5.2	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. Alteryx Server requires stored credentials in DCM to run workflows. Fixed issue where the Tableau tools returned the “list index out of range” error. Fixed issue where Tableau Input returned the “out of bounds” error. Fixed issue where Tableau Output returned an error when the Byte, Date, Time or DateTimes columns were empty. Fixed issue where the Tableau tools returned the “Mismatched column definitions” error. Fixed issue where Tableau Output didn’t display data in the results window. Fixed issue where Tableau Output didn’t display data sources correctly. Fixed issue where Tableau Input didn’t read any data and didn’t display any error. Fixed issue where Tableau Output prevented writing data to data sources with the same name in different projects. Fixed issue where Tableau Output didn’t write data to a file defined by a relative path. Fixed issue where Tableau Output in a macro didn’t work as expected.

Alteryx Tools Used to Connect

Input Data Tool	Output Data Tool Output Data Tool
Tableau Input Tool	Tableau Output Tool
Publish to Tableau Server Tool

Important

Input Data tool reads data as a Tableau Hyper data extract (HYPER) file. This tool supports only local files.
Output Data tool saves data as a Tableau Hyper data extract (HYPER) file. This tool supports only local files.
Tableau Output tool creates a Tableau Hyper dataset and uploads it to the Tableau server or saves it locally as a Tableau Hyper data extract (HYPER) file.
Publish to Tableau Server tool is deprecated. Functionality was replaced by the Tableau Output tool

In this section: