Tool migration import

Asana Importer

You can migrate from Asana to Taiga as your primary project management platform following these instructions carefully.

Disclaimer: Some Taiga product screenshots might refer to older Taiga or Asana releases. When in doubt, please follow the written instructions.

How I import a project from Asana?

Suggested step before importing your project. Read this first!

Summary: if you want to import team members too, make sure those team members are Taiga users already. A nice workaround is creating a dummy project and inviting them to it. taiga will take care of sending invites and you’ll be able to track how many users are now part of Taiga before actually importing the project itself.

When you import your project, you often want to also import your users and keep all the relations between the work items and the team members. Taiga’s import project will first look for its team members, add them to the project and then proceed with the content itself.

If those users don’t exist on that particular Taiga instance (tree.taiga.io or your self-managed Taiga instance), the import process will still go ahead but the link between content and users will be lost and it won’t be recovered even if you add those users afterwards.

If you need to keep the relationships between content and team members (for example, such team member was assigned to that task or such comment was made by that team member), you need to make sure those team members already exist on that Taiga platform. You can achieve this by asking them to sign up themselves (using the same email address that identifies them on the source platform) or creating a dummy project and invite them to it.

On the top of your Taiga screen you have the “Projects” button. After you have created/selected a project, to invite a new team member go to SETTINGS>MEMBERS (on the sidebar). On the top there is the NEW MEMBER button. You can do this in batches of five team members each. You probably can ignore the different ROLES option here since this project is temporary.

Taiga will send invites to all users that are not yet part of the platform and you will be able to track how many invites have been accepted. You can resend invites as much as you want.

Whenever you are happy with the number of people that were part of Taiga, either by signing up or accepting your invitation, you can proceed with a project import. This way, you will be able to seamlessly start working on Taiga. After this, you can safely remove the dummy project since it probably doesn’t provide any value any more.

For more project customisation options, be sure to check The Project Customisation Guide

Disclaimer: Some Taiga product screenshots might refer to older Taiga or Asana releases. When in doubt, please follow the written instructions.

  1. To start the importation project, you have to got to your project menu, and click on “New Project” button.
New project creation

New project creation

  1. After that, you can select how to create the project, in this case we want to “Import project”.
Start import process

Start import process

  1. You can select which importer do you want to use, in this case, you have to select the “Asana” importer.
Select importer

Select importer

  1. As soon as you select the asana importer, you will be redirected to the Asana authorization page, to allow Taiga to access to your boards (during the next day). You have to click “Allow”, to continue the process.
Authorize access to asana

Authorize access to asana

  1. Then you have to select which asana board want to import.
Select Asana board

Select Asana board

  1. Once you have selected the board you have to define how you want to import the project. This include:
  • The title of the project.
  • The description of the project.
  • If the project is public or private
  • If you want to import archived data from Asana.
  • If you want to keep a link from your taiga User Stories to the original asana cards.
Fill new project information

Fill new project information

  1. Before finish the import process you have to match your Asana users with your Taiga users, this allow us to keep assignation, creation and comments author information correctly.
Select users

Select users

  1. Finally, you only have to click “Import” button to start the import process, this can take a while, so be patient.
Confirm users selection

Confirm users selection

  1. After the import process, you can access to your new created project that will looks like this.
Imported project

Imported project

Wich data is imported, and how?

  • Asana Board as Taiga Kanban Project.
  • Board avatar as Project avatar.
  • Board columns as Taiga Kanban columns (User story statuses).
  • Cards as User Story (Optionally archived cards).
  • Cards Checklists tasks as User story tasks.
  • Board members as Project members.
  • Tags and tags colors.
  • Due Date field as Taiga custom field “Due date”.
  • Comments.
  • Attachments.
  • Changes in title, description, due date and state.
  • Card assignations as User Story assignation for the first, and User Story watchers for the rest.