Import data directly from Asana into Jira

Moving your work from Asana to Jira just got easier. Using the Asana importer, you can directly import projects from Asana into a software project. This can help save the effort of manually moving data and ensure the project information is relevant and accurate.

Structure of your Asana project in Jira

When you use the Asana importer to import your project, it directly pulls information from your Asana account and creates a similar project structure and hierarchy in Jira.

Here’s how your Asana project data will be structured in your new software project:

• Sections from Asana, such as To do, Doing, Done, etc., will be imported as issue statuses.

• Tasks from Asana will be imported to as issues.

• Subtasks from Asana will be imported as subtasks. To maintain a similar hierarchy as Asana, each subtask will be linked to its parent subtask within an issue.

Once your Asana project is imported, you can customize the issue hierarchy to your needs.

Asana standard fields and custom fields supported in Jira

Both Asana and Jira have two types of fields:

• Standard or system fields: These fields are “built-in” or part of the software by default.

• Custom fields: These fields are customizable based on the user’s needs.

During import, the Asana importer maps the standard/system and custom fields from an Asana project to the new software project.

Standard or system fields

Asana standard fields are mapped to Jira system fields in the following manner:

Asana fields not part of the standard list will be created as custom fields in Jira.

Custom fields

Here’s how custom fields will be mapped in Jira:

Import data using the Asana importer

To directly import your data using the Asana importer:

1. From the navigation bar, select Projects > Create project > Import data on the sidebar.

   • You can also navigate to the page through your settings. Select Settings (⛭) > System > External System Import on the sidebar.

2. Select Asana.

3. Select Allow in the OAuth screen to provide access to your Asana account.

4. Select the Asana workspace and the Asana project from where you’d like to move your data. Select Next.

5. Select a project template, customize the name of your software project, and select Next.

   1. The Key will automatically be selected for you. You can customize it if needed. You can also modify the Project name and Key later in the Project settings.

6. The Review details screen will summarize how your Asana data will be imported in four sections:

   • Project hierarchy: View how the Asana project structure will be replicated in Jira.

   • Field mapping: View and customize how your Asana standard and custom fields are mapped in Jira.

   • Import attachments: You can choose to import or not import attachments into your new project.

   • Import all members: Select if you’d like to import members from your Asana account. If you choose not to import members, all user fields will be unassigned, user mentions in comments will be imported as plain text, and commenter names will change to Anonymous.

     • Product admins can only move existing users from the site into the project. To add new users, contact an organization admin to invite them before proceeding with the import.

7. Select Import when you’re ready to start importing your data.

Contact support if you’re facing any issues with your import.

Customize fields in your software project

You can customize how the Asana fields are imported into your software project during the import.

The Review details screen will summarize how your data will be mapped to the new software project. Select Field mapping. This screen will show how your Asana data is automatically mapped.

Here you can:

• Alter how your Asana data is mapped.

• Use the toggle buttons to choose not to include specific fields in your import.

To customize your fields:

1. Select the dropdown of the field you want to edit.

2. You can either select an existing field from the options provided or select a custom field that best suits the format of your field. If you select a custom field, it’ll take the same name as your Asana field.

Once you’ve customized your fields, select Back to Review details to head back to the Review details screen. Your changes will be saved.

Few notes on customizable fields

• The Summary and Issue status are required fields in Jira. They can’t be modified or excluded from an import.

• Although Assignee, Due date, and Start date fields can be omitted from your import, we suggest including them for a better Jira experience.

  • When the assignee field is excluded from an import, assignee information will not be displayed in issues, comments, and tags.