Import data directly from ClickUp into Jira

Moving your work from ClickUp to Jira just got easier. Using the ClickUp importer, you can directly import up to 10 Lists from ClickUp to Jira. This can help save the effort of manually moving data and ensure the project information is relevant and accurate.

Import data from ClickUp

To directly import your data using the ClickUp importer:

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

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

2. Select ClickUp from the list of apps.

3. Select Connect Workspace in the OAuth screen to provide access to your ClickUp account.

4. Select where you’d like to import your data from, first select your ClickUp Workspace, Space, then Lists (up to 10).

   • Once you’ve selected your Lists, you'll see an About your ClickUp project section showing you the number of issues that will be imported.

5. Select Next.

6. Create a new software project in Jira. This is where your data from ClickUp will be imported. You can customize the name of the project, its access, and key type. Then select Next.

   • The Key will automatically be selected for you. You can customize it as needed. You can also modify the project name and key later from your project settings.

   • Your data will be imported into a Kanban template.

7. Next, review the details for your new project. The Review details screen will summarize how your ClickUp data will be imported:

   • Project hierarchy: View how the ClickUp Lists will be structured in Jira.

   • Field mapping: View how your ClickUp standard and custom fields will be mapped in Jira. Use the dropdown lists to customize each field.

   • Status mapping: View how your ClickUp statuses are mapped in Jira. Use the dropdown lists to customize each status.

   • Import users: You can choose to import user data such as assignees, mentions, and people to your new project.

     • 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.

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

   • Import comments: You can choose to import issue comments to your new project.

8. Select Import when you’re ready to start creating your new project and importing data.

The importer will automatically start bringing over the data from ClickUp in the background. You can continue to work on other things in the meantime, while following the progress of your import at the top of your screen.

Once the data is imported, refresh the page to see the issues on your Kanban board.

ClickUp import times and rate limit

The time it takes to complete the import of your Lists to Jira will vary depending on your ClickUp plan. This is because ClickUp applies rate limits per token.

Structure your data in Jira

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

Here’s how your ClickUp data will be structured in Jira:

• Statuses will be imported as issue statuses.

• Lists will be imported as epics and issues.

• Tasks will be imported as tasks. Each subtask and nested subtask will be imported as subtasks linked to its respective parent task.

Once your Lists are imported, you can customize the issue hierarchy.

Customize your statuses

We’ll automatically map your ClickUp statuses to a Jira status; To Do, In progress, or Done. You can select a status from the list, or add a new custom status for future use.

To select or add a new status:

1. Select the drop-down of the status you want to change.

2. Select a status from the list, or type in the name of the new status you want to add.

   1. You can also start typing to search.

3. Select the status you want.

4. If you added a new status, confirm the Status name and Status category, then select Add. Read about issue statuses

5. You should now see your newly added status in the drop-down field.

Edit fields in your Jira project

You can customize how your ClickUp fields are imported to Jira.

The review screen will summarize how your data will be mapped to the new project. Select Field mapping – this screen will show how your ClickUp data is automatically mapped.

Here you can:

• Alter how your ClickUp data is mapped.

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

To customize your fields:

1. Select the drop-down 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 ClickUp field.

Once you’ve customized your fields, select Back to review details to save your changes and go back.

Supported ClickUp fields

Both ClickUp 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.

The data from your ClickUp fields can map to either system fields or custom fields in Jira in the following manner:

Unsupported ClickUp fields

The following ClickUp field types can’t be mapped to either system or custom fields in Jira and aren’t supported as part of the import:

• Task cover image

• Formula

• Progress (auto)

• Progress (manual)

• Rollup

• Tasks

Some comment types are also not supported:

• Task mentions

• Embedded view

• Replies to comments