--- schema_version: "1" id: 0a224138b5b7df7a6e43122b96ad0b908bda00fe5885f7c25230ce80baefd580 title: Tableau Migration SDK Overview collection: tableau version: next locale: en-us portal_url: https://docs.salesforce.com/tableau/next/en-us/api/migration_sdk/index.md canonical_url: https://help.tableau.com/v0.0/api/migration_sdk/en-us/index.html source_site: help.tableau.com content_type: documentation content_hash: 5407422a51821d9ae50afe8019f4bccf34600cf89bc34f96344bb92b3c9b53e8 description: Documentation for the Tableau Migration SDK --- # Tableau Migration SDK Overview 🕐 _3 min read_ ## Migration SDK Overview Customers worldwide are migrating to Tableau Cloud to take advantage of the innovation, reduced cost, security, and scalability of Tableau’s managed data service. The [Tableau Migration Software Development Kit (SDK)](https://github.com/tableau/tableau-migration-sdk) helps you migrate to Tableau Cloud in a seamless and predictable way. You can use the Migration SDK to build your own migration application to do the following: - Migrate users and groups - Migrate content like data sources and workbooks - Migrate and, in some cases, modify your robust governance structure for your content in Tableau Cloud **Note**: The Tableau Migration SDK is for migrating **from** Tableau Server **to** Tableau Cloud. Tableau Server to Tableau Server and Tableau Cloud to Tableau Cloud migrations are not currently supported with the Migration SDK. To migrate content between Tableau Server sites or between Tableau Cloud sites, use the [Tableau Content Migration Tool](https://help.tableau.com/current/server/en-us/cmt-intro.htm). With any migration project, you can also: - Migrate content items like Workbooks, Data Sources and Projects from Tableau Server to Tableau Cloud - Capture logs of essential actions taken - Transform essential aspects of users, content, and governance in-flight The Migration SDK gives you the tools to go from “lift and shift” methodologies to optimization in a Cloud-native environment. We’ve enriched the documentation and instructions to highlight opportunities to optimize your Tableau Cloud deployment for simplicity of administration, automation, and enriched data cultures following a migration. ### What should the Migration SDK be used for? - The Migration SDK is used for the technical movement of users and content during a migration from Tableau Server to Tableau Cloud. - The migration should be a one-time event rather than a recurring content promotion (such as a migration from development to production). - The Migration SDK is a framework for your custom-coded projects. The SDK is not a standalone application that performs Tableau Server to Tableau Cloud migrations with no coding required. ### Who can use the Migration SDK? The Migration SDK was designed for junior level developers and above who are familiar with Tableau and have experience in either Python or .NET. The Migration SDK gives you the tools to develop your own migration application. More details on the supported platforms and hardware requirements can be found in [Installation](/v0.0/api/migration_sdk/en-us/docs/installation.html). ### When to use the Migration SDK The Migration SDK is used for the technical movement of users and content during a migration from Tableau Server to Tableau Cloud. The following image is helpful if you’re thinking about migrating to Tableau Cloud and where the Migration SDK fits into that process. This image shows an overview of the various teams and decisions that are needed for a successful migration. ![Summary of migration models](/tableau/next/en-us/api/migration_sdk/en-us/assets/when-to-use-msdk.jpg) ### When not to use the Migration SDK 1. We don’t recommend that all Tableau Server customers migrate to Tableau Cloud. This is because of compliance or use case compatibility. Be aware of the [differences between Tableau Server and Tableau Cloud](https://help.tableau.com/current/server/en-us/migrate_server_to_cloud_overview.htm) and confirm your plans with your accounts teams before migrating to Tableau Cloud. 2. If you have fewer than 100 users, we recommend using the [Tableau Cloud Manual Migration Guide](https://help.tableau.com/v0.0/guides/migration/en-us/emg_intro.htm) instead. Customers fitting this profile usually migrate faster and don’t require development investment using a manual method. On average, this process usually takes customers of this size under two weeks to migrate to Cloud. 3. If you have more than 100 users and do not have internal resources familiar with Python or C#, we recommend leaning on [Tableau Professional Services](https://www.tableau.com/resources/teams-organizations/professional-services) or our [Experienced Migration Partners](https://www.tableau.com/why-tableau/tableau-migration). ## Migration blockers While most customers will benefit from migrating from Tableau Server to Tableau Cloud, there are a few unique scenarios that might require you to continue to use Tableau Server. Check with your Tableau account team or a Partner for advice, or consider [potential migration obstacles](https://help.tableau.com/current/server/en-us/migrate_server_to_cloud_overview.htm). ## Platform differences While Tableau Server and Tableau Cloud are remarkably similar, there are some differences between the two products that impact how you migrate. We call out these differences within specific migration steps in the Migration SDK documentation. However, the following links offer some high-level items to keep in mind when you’re planning your migration. - [Summary of platform differences](https://help.tableau.com/current/server/en-us/migrate_server_to_cloud_overview.htm) - [Version differences](https://public.tableau.com/app/profile/tableau.core.product.marketing/viz/ReleaseNavigator-V21/FeaturesInVersionDash) ## Technical limitations The Migration SDK is a framework for your custom-coded projects. The SDK _is not_ a standalone application that performs Tableau Server to Cloud migrations with no coding required. The Migration SDK relies exclusively on REST API functionality to migrate content. If a content item doesn’t yet have the necessary REST API functionality, those items could need to be migrated manually by end users. We have detailed these items in [Data not support by the Migration SDK](/v0.0/api/migration_sdk/en-us/docs/planning.html#data-not-supported-by-the-migration-sdk). ## More information For more information about manual processes, see the [Tableau Cloud Manual Migration Guide](https://help.tableau.com/current/guides/migration/en-us/emg_intro.htm). **Tip**: If you're looking to increase your productivity as you interact with the Tableau Server REST API for regular Tableau Server usage, see [Tableau Server Client](https://tableau.github.io/server-client-python/docs/).