NNaatOps
Start free

Import from Jira or CSV

Bring a Jira Cloud project straight over, or import issues from a CSV export, with a check before anything is created.

Owners, admins and managers can bring work in from other tools in Settings › Import. There are two ways:

  • Jira Cloud connects to your Jira site and brings a whole project over: issues, sprints, comments and attachments. Use this if you're moving off Jira.
  • CSV file imports issues from a spreadsheet export, from Jira or any other tool.

Test cases have their own importer on the Tests tab; see Test cases and test runs.

Before you import

  • Create the project in NaatOps first. Import into an empty project, or one you're happy to add to.
  • Invite your team first. People are matched to members by email or name. Work for people who aren't in the workspace yet comes over unassigned.
  • Check the workflow. Each Jira status is mapped to one of your project's statuses, so add any you want to keep (such as Code Review) in Settings › Workflows before you start.

Import from Jira Cloud

You need a Jira account that can browse the project, and an API token for it.

  1. In Jira, open your Atlassian account's Security › API tokens (the Make one in your Atlassian account link on the form goes there) and create a token. Copy it.
  2. In NaatOps, open Settings › Import. Jira Cloud is the first tab.
  3. Fill in:
    • Into project: the NaatOps project to import into.
    • Jira site: your Jira address, such as yourcompany.atlassian.net. You can paste any link from your Jira, and NaatOps keeps just the site.
    • Your Jira email and the API token.
    • Jira project key: the letters before the issue numbers, such as PAY for PAY-12.
    • Only some issues (optional JQL): leave it empty to bring everything, or narrow it, such as created >= 2025-01-01.
  4. Choose Connect and preview.

Connecting to JiraConnecting to Jira

The token is used for this import only and is never saved. Only Jira Cloud addresses ending in atlassian.net are accepted.

Check the preview

Nothing is created yet. The preview shows:

  • The Jira project and how many issues it has.
  • How many people in Jira match members here, and who doesn't. Invite them now if their work should stay assigned to them.
  • Statuses: each Jira status and the NaatOps status it becomes. NaatOps matches by name first, so Code Review goes to In Review and Ready for QA to QA, and otherwise picks by status group (to do, in progress, done). Change any that should land somewhere else.
  • Comments and Attachments, both ticked. Untick either to leave it behind.

Checking the Jira previewChecking the Jira preview

Choose Import N issues. The import runs in the background with a progress bar. You can leave the page; come back to Settings › Import to see how it's going.

When it finishes you see how many issues came over and their new keys, how many were linked to parents, the issue links, comments and attachments, the sprints it added, anyone left unassigned and any files it couldn't copy. Choose Open the backlog to see them.

A finished Jira importA finished Jira import

What comes over from Jira

  • Issues: epics, stories, tasks, bugs and sub-tasks, each under its parent (or its epic, on older Jira projects).
  • Fields: status, priority (Jira's Highest becomes Critical), assignee and reporter, story points, labels, due date and the original created date.
  • Descriptions and comments, with their headings, lists, code, tables, links and mentions. A comment keeps its author when they're a member, and otherwise starts with "Name wrote in Jira:". Comments keep their original date.
  • Sprints, with their dates and goal. Closed sprints become completed, the active sprint becomes active and future sprints are planned. Unfinished work from a closed sprint goes back to the backlog, as in Jira.
  • Issue links, such as blocks, duplicates and relates to.
  • Attachments, copied into NaatOps. Files bigger than the storage limit are listed as not copied.
  • Backlog order stays as it was in Jira.

Issues get new keys in your project, in the same order. Each issue's activity notes the Jira key it came from, such as Imported from Jira PAY-4.

Run it again

You can import the same Jira project again at any time. Only issues added in Jira since the last run come over; ones already here are left as they are, and the preview says how many. When there's nothing new, the button says Nothing new to import. This lets a team keep using Jira for a while during the move and bring the new work across at the end.

Only one import runs in a project at a time. If an import stops before it finishes, the page says so; run it again to bring over the rest.

Large projects

Up to 10,000 issues come over in one run. For a bigger project, use the JQL box to import in parts, such as created < 2024-01-01 and then created >= 2024-01-01.

If it doesn't connect

  • Use your Jira Cloud address: the site must end in atlassian.net. Jira Server and Data Center can't connect directly; use a CSV export instead.
  • Jira didn't accept that email and API token: check the email is the one you sign in to Jira with, or make a new token.
  • There's no Jira project …: check the project key, and that your Jira account can see that project.

Each import is recorded in Settings › Audit log.

Import a CSV file

Use this for Jira Server or Data Center, or for any tool that exports a CSV with a header row.

In Jira, open Filters, search for the issues you want, then choose Export › Export CSV (all fields).

  1. Open Settings › Import and choose the CSV file tab.
  2. Pick the project under Into project, then choose the CSV file. Up to 2,000 rows at a time.
  3. Check where each field comes from. NaatOps fills this in from the column names: title (required), type, status, priority, assignee, description, story points, labels, due date, sprint, original key and parent or epic link.
  4. Under Statuses, map each status in the file to one of your workflow's statuses.
  5. Look at the first rows, then choose Import N issues.

Checking the CSV import mappingChecking the CSV import mapping

From a CSV:

  • Types (Epic, Story, Task, Bug, Sub-task) and priorities come over. Jira's Highest becomes Critical.
  • Story points, labels and descriptions come over.
  • Sprints come over by name. If the project already has a sprint with the same name (for example Sprint 1), issues go into it. Otherwise NaatOps creates it: sprints whose issues are all done are marked completed, the rest are planned. Start the current one from Sprints after the import.
  • Parents and epic links are kept, using the original Jira keys.
  • Issues get new keys in your project, such as CP-1, CP-2.

For large backlogs, split the export into files of up to 2,000 rows and import them one after another, parents first. Comments and attachments don't come over from a CSV; use the Jira Cloud import for those.

On yearly Firm Pack plans, we do the migration from Jira and Excel for you.