---
schema_version: "1"
id: f0f97f7b39a3bf445424a1716c3c123c704632cd7e8a4a6a64e8a01bc8cc7040
title: Migration Limitations
collection: tableau
version: next
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/next/en-gb/online/cmt-migration_limitations.md
canonical_url: https://help.tableau.com/v0.0/online/en-gb/cmt-migration_limitations.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 9727ef196f88ad57d34aa01509623dfbb442c7359a73c63689ca3ec856a665a6
description: Review Content Migration Tool limitations for version compatibility and unsupported content.
---
[Skip to main content](#main-content)

# Migration Limitations

There are certain limitations to migrations when using the Tableau Content Migration Tool. Before creating your migration plan, review the sections below to learn about version compatibility and content that will not be migrated.

## Compatibility with Tableau content

The Content Migration Tool supports migrating workbooks and published data sources saved in the eight most recent versions of Tableau. Workbooks and published data sources saved before version 2018.1.x are not supported by CMT. For more information, see [Getting Started with Tableau Content Migration Tool](https://help.tableau.com/v0.0/online/en-gb/cmt-getting-started.htm).

Migrating content to previous Tableau versions can fail if the content includes features or formats not recognised by the previous version. The Content Migration tool will tell you if incompatibilities are found, and the migration will fail.

## Configurations

The following configurations are not migrated to the destination site when using the Content Migration Tool.

- [Users](https://help.tableau.com/current/server/en-gb/users_add.htm)
- [Groups](https://help.tableau.com/current/server/en-gb/users_add_group.htm)
- [Site settings (custom logos, view recommendations, etc.)](https://help.tableau.com/current/server/en-gb/sites_add.htm)

## Data connections

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](https://help.tableau.com/v0.0/online/en-gb/cmt-plan_workbooks.htm) and [Migration Plans: Published Data Sources](https://help.tableau.com/v0.0/online/en-gb/cmt-plan_datasources.htm).

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Actian Matrix</p><p>Actian Vectorwise</p><p>Amazon Athena</p><p>Amazon Aurora</p><p>Amazon EMR</p><p>Amazon Redshift</p><p>Apache Drill</p><p>Aster Database</p><p>Box</p><p>Cloudera Hadoop</p><p>Delimited Text File</p><p>EXASOL</p><p>Firebird</p><p>Google Analytics</p><p>Google BigQuery</p><p>Google Cloud SQL</p></td><td><p>Google Drive</p><p>HortonWorks Hadoop Hive</p><p>HP Vertica</p><p>IBM DB2</p><p>IBM Netezza</p><p>Map R Hadoop Hive</p><p>Microsoft Access</p><p>Microsoft Analysis Services</p><p>Microsoft Excel</p><p>Microsoft Excel Direct</p><p>Microsoft OneDrive</p><p>Microsoft SQL Server</p><p>MySQL</p><p>OData</p><p>Oracle</p><p>Oracle Essbase</p></td><td><p>Pivotal Greenplum Database</p><p>PostgreSQL</p><p>Progress OpenEdge</p><p>Salesforce</p><p>SAP HANA</p><p>SAP Sybase ASE</p><p>SAP Sybase IQ</p><p>Snowflake</p><p>Spark SQL</p><p>Statistical File</p><p>Tableau Extracts</p><p>Tableau Server Data Sources</p><p>Teradata</p><p>Text File</p><p>Web Data Connector</p><p>Other Databases (ODBC)</p></td></tr></tbody></table>

## Unsupported content

The following content is not migrated to the destination site when using the Content Migration Tool and will require additional configuration.

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>Content</b></td><td><b>Action required</b></td></tr><tr><td>Ask Data lenses</td><td>Users must recreate Ask Data lenses on the destination site. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/ask_data_lenses.htm" class="xref">Create Lenses that Focus Ask Data for Specific Audiences</a>.</td></tr><tr><td>Collections</td><td>Users must recreate collections on the destination site. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/collections.htm" target="_blank">Collections</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</td></tr><tr><td>Comments</td><td>Users must re-add comments to views on the destination site. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/comment.htm" target="_blank">Comment on Views</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</td></tr><tr><td>Custom views</td><td>Users must recreate custom views on the destination site. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/customview.htm" target="_blank">Use Custom Views</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</td></tr><tr><td>Data freshness policy</td><td>Defaults to the site default upon publishing. Users must manually set it up if a specific freshness policy is needed. For more information, see <a href="https://help.tableau.com/current/online/en-gb/data_freshness_policy.htm" target="_blank">Set a Data Freshness Policy</a> in <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> or <a href="https://help.tableau.com/current/server/en-gb/data_freshness_policy.htm" target="_blank">Set a Data Freshness Policy</a> in <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> help.</td></tr><tr><td>Data roles</td><td>Users must recreate data roles on the destination site. For more information, see <a href="https://help.tableau.com/current/prep/en-gb/prep_validate_data.htm" target="_blank">Use Data Roles to Validate your Data</a> in <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span> help.</td></tr><tr><td>Data source certifications</td><td>If you have the following site roles and capabilities, you can certify data sources on the destination site.<ul><li><p>Site Administrator Creator</p></li><li><p>Creator or Explorer (can publish) with Project Leader capability on the project containing the data source</p></li></ul><p>For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/datasource_certified.htm" class="xref">Use Certification to Help Users Find Trusted Data</a>.</p></td></tr><tr><td>Data-driven alerts</td><td>Users must recreate data-driven alerts for dashboards and views on the destination site. After data-driven alerts are created, anyone with access to the view can add themselves to existing alerts.<p>For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/data_alerts.htm" target="_blank">Send Data-Driven Alerts from <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> or <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span></a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</p></td></tr><tr><td>Descriptions for workbooks and data sources</td><td>If you own the content item or have the appropriate permissions, you can edit the item's description on the destination site. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/qs_content_page.htm" target="_blank">Add or edit descriptions</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</td></tr><tr><td>Embedded credentials</td><td><p>For security purposes, <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> removes embedded credentials from data sources during the download process.</p><ul><li><p>To include embedded credentials when migrating from <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> to <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>, use the Migrate Embedded Credentials for Workbooks and Migrate Embedded Credentials for Data Source publish options. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/cmt-migration_embedded_credentials.htm" class="xref">Migrate Workbooks and Data Sources with Embedded Credentials</a>.</p></li><li><p>To include embedded credentials when publishing to <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> sites, use the Set Connection Info data source transformation. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/cmt-plan_datasources.htm" class="xref">Migration Plans: Published Data Sources</a>.</p></li></ul><p class="note"><b>Note:</b> CMT does not support embedded credential migration for OAuth connections. To migrate OAuth credentials, use the Set Connection Info data source transformation.</p></td></tr><tr><td>External assets</td><td>Customised attributes for external assets are not migrated to the destination site. For example, tags, certifications, data quality warnings, descriptions, permissions, user contacts, tables and columns must be recreated. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/dm_perms_assets.htm" class="xref">Manage Permissions for External Assets</a>.</td></tr><tr><td>Extract refresh schedules</td><td>Extract refresh schedules cannot be migrated to <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> destination sites. To refresh data on <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>, you can run extract refreshes manually or create new extract refresh schedules. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/schedule_add.htm" class="xref">Schedule Refreshes on Tableau Cloud</a>.</td></tr><tr><td>Favourites</td><td>Users must reselect their favourite content on the destination site. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/favorites.htm" target="_blank">Mark Favourites</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</td></tr><tr><td>Flows</td><td>To run flows on a schedule, users must republish flows to the destination site with Tableau Prep. For more information, see <a href="https://help.tableau.com/current/prep/en-gb/prep_conductor_publish_flow.htm" target="_blank">Publish a Flow to <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> or <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span></a> in Tableau Prep help.</td></tr><tr><td>Incremental extract refreshes</td><td>Incremental extract refreshes are changed to full extract refreshes on the destination site. Users must reconfigure incremental refreshes in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> and publish extracts to the destination site after migration. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/extracting_refresh.htm#configure-an-incremental-extract-refresh" target="_blank">Refresh Extracts</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</td></tr><tr><td>Metrics</td><td><p>The historical values for metrics are removed from views, and users must recreate metrics on the destination site. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/metrics_create.htm" class="xref">Create and Troubleshoot Metrics (Retired)</a>. The legacy Metrics feature was retired in February 2024 for Tableau Cloud and in Tableau Server version 2024.2. For more information, see <a href="https://help.tableau.com/current/online/en-gb/metrics_create.htm">Create and Troubleshoot Metrics (Retired)</a>.</p></td></tr><tr><td>Revision history</td><td>To migrate previous versions of workbooks to the destination site, users must download the versions they wish to keep and republish the workbook to the destination site. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/qs_revision_history.htm" target="_blank">Work with Content Revisions</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</td></tr><tr><td>Subscriptions</td><td>Users must resubscribe to views and workbooks on the destination site. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/subscribe_user.htm" class="xref">Create a Subscription to a View or Workbook</a>.</td></tr><tr><td>Thumbnails for workbooks and views</td><td>Workbooks and views that are migrated using the <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> will retain their original thumbnails, even if the migration plan includes transformations that result in the views being rendered differently (for example, if data connections change).<p>To update thumbnails, edit the workbook or view on the destination site and re-save it. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/web_author_build_view.htm" target="_blank">Edit Tableau Views on the Web</a> in <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> help.</p></td></tr><tr><td><p>Virtual connections</p></td><td>Users must recreate virtual connections on the destination site. For more information, see <a href="https://help.tableau.com/v0.0/online/en-gb/dm_vconn_create_conn.htm" class="xref">Create a Virtual Connection</a>.</td></tr></tbody></table>