Exporting issues

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Create a backup of your Jira Cloud site, including attachments. Backups help you restore and recover data, or migrate to Jira Server or Jira Data Center.

You can export the following data to backup your Jira Cloud site: 

  • Issues
  • Users and user group settings
  • Issue attachments, user avatars, and project logos (if selected)

You can backup your Jira data at any time. However, if you include attachments, avatars, and/or logos, you'll need to allow 48 hours between backups.

How to create a backup for Jira Cloud

To create a backup for cloud:

  1. Choose > System

  2. In the IMPORT AND EXPORT section, click Backup manager.

  3. Under Backup for cloud, select Create backup for cloud.

You can tick the Include additional files option if you want to include issue attachments, user avatars, and project logos in the export.

After the backup is complete, select Download backup file.

How to create a backup for Jira Server or Jira Data Center

To create a backup for server:

  1. Choose > System
  2. In the IMPORT AND EXPORT section, click Backup manager.
  3. Under Backup for server, select Create backup for server.

You can tick the Include additional files option if you want to include issue attachments, user avatars, and project logos in the export.

After the backup is complete, select Download backup file.

A note about next-gen projects and server backups

Jira Cloud products are regularly updated with the absolute latest features and improvements. They run on completely different branches of development than the latest downloadable version of Jira Server or Jira Data Center products. Some of these features are incompatible between cloud and server products.

Next-gen projects, for example, do not exist in Jira Server or Jira Data Center. To create a usable server backup, you need to delete all next-gen projects from your Jira Cloud site. Learn more about next-gen projects.

We recommend moving important issues from these projects into server-supported project templates (those administered by schemes). To do so:

  1. Create new, server-supported projects to receive issues from each next-gen project.
  2. Choose > System
  3. In the IMPORT AND EXPORT section, click Backup manager.
  4. Under Backup for server, select Move issues and follow the instructions to move important issues over to your new server-supported projects.

Jira lists all your next-gen projects, links to filters that contain those projects' issues, and information about the project's owner to help you investigate what issues you may want to keep in your backup.

You can also delete all next-gen projects outright. To do so:

  1. Choose > System
  2. In the IMPORT AND EXPORT section, click Backup manager.
  3. Under Backup for server, select Delete all next-gen projects.

How to structure the export file

Once you have generated and unzipped a backup file, you should have an output similar to the following:

JIRA-backup-20161021
├── activeobjects.xml
├── entities.xml
├── data
│   ├── attachments
│   └── avatars
└── logos

Note that database data is stored in both activeobjects.xml and entities.xml. Issue attachments, user avatars and project logos are stored in corresponding directories. If you don't want to import attachments, avatars or logos to your new Jira Cloud site, you can remove the corresponding directory and then zip the modified directory tree before importing. 

How to import backup data into Jira Cloud

  1. First, we recommend splitting your cloud backup file into two separate files: a database file containing your activeobjects.xml and entities.xml, and a separate one for your attachments and other media. This can help avoid timeout errors and reduce the risk of issues when importing.
  2. Once you've split your backup into separate database and media files, follow the instructions on importing issues to import them to cloud. 
  3. After the import, log in to your new Jira Cloud site with the same admin account you used to log in to your original site. 

Note that cross-application links (links to a source file page from a Jira issue) will point back to the corresponding source location after the import.

How to import backup data into Jira Server

  1. Structure your export file as mentioned above. 
  2. Follow the instructions on the Migrating from Jira Cloud to Jira Server page.
  3. After the import, log into your Jira Server instance with the sysadmin username and corresponding password. 

Cross-application links (links to a source file page from a Jira issue) will point back to the corresponding source location after the import.

We create the sysadmin user during the backup process. This user is created to allow you to log in with the necessary Jira System Administrator permission (a server-specific permission not available in the cloud) after restoring data in Jira.

Last modified on Feb 13, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.