Getting Started with Tableau Content Migration Tool
This article will help you get started with the Tableau Content Migration Tool. It contains links to other articles about information you need to prepare before installing the Content Migration Tool, and steps to design a migration plan and upgrade existing installations.
The Content Migration Tool can only be installed on Windows operating systems. Before installing, you must be able to connect to the Tableau source site (the site you are migrating from) and the destination site (the site you are migrating to) from the computer where Content Migration Tool is installed. Both the source and destination sites must have a valid Advanced Management license. For more information about installing and upgrading Content Migration Tool, see Install Tableau Content Migration Tool.
Content Migration Tool version 2022.2.1 and later support content migration for all Tableau Cloud deployments. We recommend installing the most recent version from the Tableau Advanced Management(Link opens in a new window) downloads page to take advantage of the latest features and fixes.
The Content Migration Tool supports content migration for Tableau Server versions 2019.3 and later.
The table lists compatible versions of Tableau Server based on the installed version of Content Migration Tool.
|CMT Version||Tableau Server Version|
|2023.1.x||2021.2.x - 2023.1.x|
|2022.4.x||2021.1.x - 2022.4.x|
|2022.3.x||2020.4.x - 2022.3.x|
|2022.2.x||2020.3.x - 2022.2.x|
|2022.1.x||2020.2.x - 2022.1.x|
|2021.4.x||2020.1.x - 2021.4.x|
|2021.3.x||2019.4.x - 2021.3.x|
|2021.2.x||2019.3.x - 2021.2.x|
|2021.1.x||2019.3.x - 2021.1.x|
|2020.4.x||2019.3.x - 2020.4.x|
|2020.3.x||2019.3.x - 2020.3.x|
Note: If you have a Tableau Server deployment, you can migrate content between projects on a Tableau Server installation and a Tableau Cloud site. Both sites must have a valid Advanced Management license.
The Content Migration Tool supports migrating workbooks and published data sources saved in the eight most recent versions of Tableau. While you can migrate existing data sources, only data sources that use the connection types in the table below can be changed and modified during migration. For more information, see Data Source Transformations in Migration Plans: Workbooks and Migration Plans: Published Data Sources.
Delimited Text File
Google Cloud SQL
HortonWorks Hadoop Hive
Map R Hadoop Hive
Microsoft Analysis Services
Microsoft Excel Direct
Microsoft SQL Server
Pivotal Greenplum Database
SAP Sybase ASE
SAP Sybase IQ
Tableau Published Data Source
Web Data Connector
Other Databases (ODBC)
Before you start, make sure you understand the limitations when migrating content using the Content Migration Tool. For more information, see Migration Limitations.
The Content Migration Tool walks you through migrating content across projects on a single site, to a new site on the same Tableau Server instance, and to sites that exist on different Tableau Server instances. The plan you create can be saved and used again for future migrations. For more information, see Migration Plan Overview.