Import data directly from ClickUp to a new Jira project

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, then Create a new project.

2. From the sidebar, select More, then Import data.

3. Select ClickUp from the list of apps.

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

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

6. Select Next.

7. You’ll need to set up your new Jira project’s name, type, access, and key. Then select Next.

   • The key will automatically be created for you – you can customize it if needed. You can also modify the project name and key later in your project settings.

8. 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. You can customize each field from the dropdown field.

   • Status mapping: View how your ClickUp statuses are mapped in Jira. You can customize each status from the dropdown field.

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

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

9. 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, you’ll need to refresh the page to see your new issues on your board. Read more about the board view in business projects.

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. Learn more about ClickUp's rate limits by Workspace plan.

Structure your Lists 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 more about status categories

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 standard fields or custom fields in Jira.

Standard or system fields

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

Unsupported ClickUp fields

The following ClickUp field types can’t be mapped to either system or custom fields inJira 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