Import data from a business space to a software space

Moving your work across Jira different types of spaces (business to software) just got easier.

Using the Jira importer, you can directly import your existing business data to a new software space. This helps save the effort of manually moving data and ensures all information stays relevant and accurate.

Importing data

To directly import your data using the Jira importer:

1. Next to Spaces in the sidebar, select Create space ().

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

3. In the “Import from an app” section select Jira (business space).

4. Select the space that you’d like to import data from. Once you select the space, the About this space section will display the number of work items that will be imported.

5. Select Next.

6. Now set up your new space’s name, template, access, and key. Then select Next.

   1. The key will automatically be selected, but can be customized as needed. You can also change the space name and key later in your space settings.

   2. The space type can’t be changed. It will match the space you’re importing.

7. Next, Review details for your new space. The screen will summarize how your business space data will be imported:

   • Field mapping: View and customize how the standard and custom fields in your business space will be mapped in your software space.

   • Import users: Bring users from your business space to your new space so they remain assigned to the work. This includes people fields, @mentions, and comments with attached names. These users won’t be notified.

     • If users are not imported, the reporter and assignee fields will be left blank.

   • Import attachments: Select whether to import attachments to your new space.

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

The importer will automatically start bringing over the data to your new space in the background. You’ll see a progress bar indicating the status of your import.

You can continue to work on other things and return to the page to see the progress of your import.

Once complete, refresh the page to see your work items:

• On the board view – if you selected the kanban template, or

• In your backlog – if you selected the scrum template.

Read more about using your scrum backlog

Edit fields

You can edit how the business space fields are imported to your software space.

The Review details screen will summarize how your data will be mapped in your new space. Select Field mapping. This is where you’ll find how your data has been automatically mapped.

This is where you can:

• Edit how your business space data is mapped.

• Use the toggles to indicate whether or not to include specific fields in your import.

To edit a field:

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 add a custom field type that best suits the format of your field. If you select a custom field, it’ll take the same name as your business space.

Any changes you make will be automatically saved in real-time. Once you’ve edited your fields, head back to the Review details screen.

Unsupported business space field types

The following business space fields are not supported by software spaces, and will not be included in your import:

• Category