> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datafold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tableau

> Sync Tableau workbook and data source definitions into your migration repository.

> [!NOTE]
>
> BI Tools integrations are enabled per organization for migration projects. Ask your Datafold contact or [support@datafold.com](mailto:support@datafold.com) to turn them on.

Datafold signs in to Tableau Server or Tableau Cloud with a personal access token and downloads workbook and data source definitions, without extracts. For what the sync does with them, see [BI Tools](https://docs.datafold.com/integrations/bi-tools.md).

## 1. Create a personal access token

Create a [personal access token](https://help.tableau.com/current/server/en-us/security_personal_access_tokens.htm) for a Tableau user that can see the content you want to sync. Datafold sees only what that user sees.

* The user must be able to download the workbooks and data sources in scope: the **Download Workbook/Save a Copy** and **Download Data Source** permissions, which a site role of **Explorer** or higher can hold. A site administrator sees everything on the site.
* Copy the token name and the token secret. Tableau shows the secret only once.

## 2. Add the integration in Datafold

Go to **Settings** → **Integrations** → **BI Tools**, click **Add new integration**, and choose **Tableau**. Fill in the form:

* **Server URL**: the address of your Tableau Server or Tableau Cloud pod, for example `https://tableau.example.com` or `https://prod-useast-a.online.tableau.com`.
* **Personal access token name** and **Personal access token secret**: the token from step 1.
* **Sites**: the content URL of each site to sync. The content URL is the part after `#/site/` in the browser's address bar. Type it and press Enter.
* **Default site**: also sync the Default site, whose content URL is empty.

Add at least one site, or select **Default site**. Then fill in the [shared settings](https://docs.datafold.com/integrations/bi-tools.md#settings-shared-by-both-tools) and save. Datafold tests the sign-in to each site and shows the result.

Datafold sends the stored token only to the server URL that it was saved with. To change the server URL, enter the token secret again.

## 3. Run a sync

Click **Sync now**. When the sync finishes, open the pull request from the **Latest sync** panel, then add the [mappings](https://docs.datafold.com/integrations/bi-tools.md#settings-shared-by-both-tools) for the warehouse connections that the sync found.

## Troubleshooting

* **The server's TLS certificate is not trusted**: the server uses a certificate that Datafold does not trust, for example one from a private certificate authority. On a customer-hosted deployment, add that certificate authority to the trust store of the Datafold containers. Otherwise, contact [support@datafold.com](mailto:support@datafold.com).
* **The server did not answer like Tableau Server**: check the **Server URL**. It must be the address of Tableau Server or of your Tableau Cloud pod.
* **The Tableau server is not reachable from Datafold**: allow Datafold's egress addresses (see [Securing connections](https://docs.datafold.com/security/securing-connections.md#ip-whitelisting)).
* **The server redirected to another host**: enter the URL that the server redirects to. Datafold never sends the token to another host.
* **Sign-in rejected**: check the token name and secret, that the token has not expired or been revoked, and that each site is entered as its content URL, not its name.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.