Was this page helpful?
Yes No
Tableau Help > Tableau Desktop Deployment Guide Overview > 
Welcome > Version Compatibility Between Tableau Desktop and Tableau Server

Version Compatibility Between Tableau Desktop and Tableau Server

Ideally, everybody in an organization can run the same version of Tableau Desktop and Tableau Server, but that's not always possible. In a large organization, different individuals or groups might need to use different versions of Tableau products. For example, some Tableau Desktop users might have already upgraded to 10.4 to take advantage of new features, but the IT team is still hosting Tableau Server 10.3 while they review the new features. This article describes which combinations of Tableau Desktop and Tableau Server can work together and in which ways.

Note: This article discusses only Tableau products that are still eligible for technical support. Tableau provides technical support on each version of the product for 30 months after release. For a list of versions and their support schedules, see the Support Services page on the Tableau website.

In this article

When does compatibility matter?

Compatibility is only an issue in certain circumstances:

  • Compatibility issues can arise only between major versions of Tableau products. For example, if your organization is using version 10.2 of Tableau Desktop and also using version 10.1 of Tableau Server, compatibility can be an issue. However, with maintenance upgrades there are no compatibility issues—for example, between Tableau Desktop version 10.2.1 and Tableau Server version 10.2.2.

    For purposes of compatibility, you need to pay attention only to the major version numbers. For example, in terms of compatibility, 10.1.5 is the same as 10.1. For a major upgrade, Tableau offers a range of new features and updates the look and feel of Tableau Desktop, whereas a maintenance release is to ensure that your copy of Tableau Desktop is current with features, security resolutions, and bug fixes.

    There is one exception. Tableau sometimes introduces new connector support with a maintenance release. This can introduce compatibility issues between Tableau Desktop and Tableau Server if Tableau Desktop has been upgraded but Tableau Server hasn't been.

    For example, Tableau Desktop 9.3.1, a maintenance release, introduced connector support for Kognito 8.1 data sources. You can't publish workbooks from Tableau Desktop 9.3.1 to Tableau Server 9.3.0 if the workbooks connect to Kognito. For details about data source support by release, see the Release Notes page.

  • Whether a Tableau product is 32-bit or 64-bit is not an issue for compatibility. You can use 32-bit Tableau Desktop to connect and publish to 64-bit Tableau Server, and 64-bit Tableau Desktop to connect and publish to 32-bit Tableau Server, as long as the versions are otherwise compatible.

Compatibility between versions of Tableau Desktop

Tableau Desktop users can share workbooks—for example, by emailing them or copying them to a location on the company network. But if two users are using different versions of Tableau Desktop, sharing isn't always possible. The rule is simple: a newer version of Tableau Desktop can open a workbook created with an older version, but an older version of Tableau Desktop can't open a workbook created with a newer version.

For example, suppose Amanda creates a Tableau workbook with version 10.0 of Tableau Desktop and sends it to Zachary, who has version 10.2 of Tableau Desktop. Zachary will be able to open that workbook. He'll see this message:

The workbook will be upgraded when it is saved. The upgraded file can't be read by earlier versions of the application.

Now suppose that Zachary edits the workbook and sends it back to Amanda. When Amanda tries to open it in Tableau Desktop version 10.0, the load will fail, because the workbook is now a 10.2 workbook.

The same logic applies to Tableau extracts: a newer version of Tableau Desktop can open an extract created with an older version. But an older version of Tableau Desktop can't open an extract created with a newer version.

Compatibility between Tableau Desktop and Tableau Server

A workbook created with any version of Tableau Desktop can connect to any supported version of Tableau Server. But once you are connected, compatibility can be an issue depending on the version you are using and the action you're performing.

Publishing from Tableau Desktop to Tableau Server

Tableau Desktop 10.4 and later

You can downgrade and publish workbooks to Tableau Server 10.2 and later.

Note: This option doesn't apply to data sources. For more information about compatibility requirements for publishing data sources, see the Tableau Desktop 10.3 and earlier section below.

When you publish the workbook, you will see a warning message that tells you that the workbook will be downgraded. If you continue to publish the workbook, any features or functionality that aren't available in the older version are removed for compatibility. If you open the downgraded workbook in the newer version of Tableau Desktop, you will see a message like the one shown below.

You may need to add back the features that were removed when the workbook was downgraded.

Tableau Desktop 10.3 and earlier

You can publish workbooks and data sources to Tableau Server if the version of Tableau Server is the same or newer than the version of Tableau Desktop. For example, you can publish workbooks and data sources from Tableau Desktop 10.0 to Tableau Server 10.0, to Tableau Server 10.1, or to Tableau Server 10.2. But you can't publish workbooks and data sources from Tableau Desktop 10.2 to Tableau Server 9.3 or to Tableau Server 10.1.

Downloading workbooks from Tableau Server

A workbook downloaded from Tableau Server has the same version as the source version of Tableau Desktop from which it was published—if it hasn't been edited on the server or in a newer version of Tableau Desktop. For example, suppose Amanda is running Tableau Desktop 10.0 and publishes a workbook to Tableau Server 10.3. If Zachary is also running Tableau Desktop 10.0 he can connect to Tableau Server, download the workbook, and open it.

However, compatibility issues can arise in the following scenarios.

Scenario 1: The workbook is edited and saved in Tableau Server

If someone else edits the workbook on the server, the workbook is updated to that version of Tableau Server. For example, suppose Elizabeth publishes a workbook from Tableau Desktop 10.0 to Tableau Server 10.3. Laura edits the workbook on the server, which converts the workbook to version 10.3 format. Then Zachary, who also has Tableau Desktop 10.0, can download that workbook, but can't open it. Even Elizabeth, the original author of the workbook, can download the workbook from Tableau Server 10.3 but can't open it, because she is using Tableau Desktop 10.0.

Scenario 2: The workbook is downloaded from Tableau Server but edited and saved in Tableau Desktop

If someone else downloads the workbook from Tableau Server to a newer version of Tableau Desktop and edits, saves and publishes it, the workbook is updated to the newer version of Tableau Desktop.

For example, suppose Elizabeth publishes a workbook from Tableau Desktop 10.0 to Tableau Server 10.3. Ted downloads the workbook from Tableau Server to Tableau Desktop 10.3. He edits and republishes the workbook back to the server. The workbook is now updated to the newer version. Zachary and Elizabeth, who are both using Tableau Desktop 10.0 can download the workbook but can't open it because the workbook has been updated to Tableau version 10.3.

Connecting to published extracts

Published extracts are not automatically upgraded when you refresh them on Tableau Server. Any published workbook or data source with an extract created in Tableau Desktop retains its original version when it's refreshed or appended to on Tableau Server.

Connecting to Tableau Server-based data sources

Workbooks in Tableau Desktop can use data sources that have been published to later versions of Tableau Server. However, if you connect to a data source that uses features that aren't in that earlier version of Tableau Desktop, those fields are unavailable. For example, suppose you create a workbook in version 8.2 of Tableau Desktop, and then connect to a data source on Tableau Server version 9.0 that contains fields that include level of detail expressions. In that case, those data fields are unavailable in the Tableau Desktop 8.2 workbook, because level of detail expressions were not available until Tableau 9.0.

Workbooks created in Tableau Desktop can always use data sources from an earlier version of Tableau Server. For example, a Tableau Desktop 10.1 workbook can use data sources from Tableau Server 10.0.

(Back to top)