Unable to restore Jira Cloud backup with the error 'The import archive doesn't contain entities.xml file'

Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.

Summary

When you import a site backup into Jira Cloud, the import might fail with the error "The import archive doesn't contain entities.xml file".

(Auto-migrated image: description temporarily unavailable)

Environment

Jira Cloud

Diagnosis

If you unzip the backup file, and can find that the entities.xml file is present in the backup folder along with the activeobjects.xml file.

Note: The error message can be misleading. The entities.xml file is still inside the backup folder, the import fails because the archive was created from the folder rather than from the files inside it.

Cause

This problem generally occurs when you compress the whole folder instead of individual files, and the import process is unable to locate the entities.xml file in the expected path.

Solution

To fix the archive packaging, compress the individual files directly rather than the parent folder:

  1. Open the backup folder so you can see the individual files inside it, including entities.xml and activeobjects.xml.

  2. Select the individual files inside the folder, not the folder itself.

  3. Compress the selected files into a single .zip archive.

  4. Import the new archive into Jira Cloud.

(Auto-migrated image: description temporarily unavailable)

For more details on Jira Cloud import, please refer to How to import only part of a Jira export into Jira Cloud.

Updated on September 17, 2026

Still need help?

The Atlassian Community is here for you.