Migration Plans: Source Projects

The next step in creating a migration plan in the Tableau Content Migration Tool is to select the source projects. Source projects are the projects the workbooks and published data sources will be migrated from. The projects you choose determine which workbooks are available to migrate in the next step of the migration plan.

Step 1: Select your source project

There are two options when selecting source projects, All Projects, and Specific Projects:

The All Projects option selects all projects from the source site you specified in the Servers step. The Specific Projects option allows you to select specific projects from the source site.

Note: Source projects must contain workbooks or data sources. Content Migration Tool will not migrate empty projects.

You can select each project individually or use the Select All button and then clear selections for the projects you don't want to include. If you make any changes on the source site while on this step, you can use the Refresh button to update the projects list.

Step 2: Select project options

Once the source projects are selected, select which project options to apply for the destination location. There are options to create projects that don't exist, in addition to copying project permissions and ownership from the source location. To assign new content ownership based on user mappings, select Apply User Mappings.

  • Create Destination Projects: Automatically create projects that don't exist in the destination location. Content Migration Tool will not create destination projects if the source project is empty or no workbooks or data sources are selected. By default, attempts to migrate to a non-existent project will result in a failed migration.

  • Copy Project Permissions: Copy source project permissions as closely as possible.

  • Copy Project Owner: Copy project ownership settings from the source location to assign the project owner.

  • Apply User Mappings: Apply user mappings to assign content ownership in the destination location. For more information, see Migration Plans: User Permissions Mapping.

Step 3: Continue to the next step

Once you have selected source projects, you are ready to continue to the next step of the your migration plan, Workbooks. Click Next.

Migration Plans: Workbooks

Who can do this

Tableau Server user with an Explorer role or higher. To migrate content, you must have View and Download Workbook/Save a Copy permissions for workbooks on the source site and Publishing rights (View and Publish capabilities) for target projects on the destination site. For more information, see Permissions.

Thanks for your feedback!