Migrating data from Documents for Jira Server or Data Center to Documents Cloud

You can migrate the Documents data from Jira Server to Jira Cloud. The migration process consists of two main steps: first, export the documents from Jira Server along with their metadata and then, import the exported data into Jira Cloud by using the Documents Cloud Uploader utility.

Follow these steps to migrate the documents of a Jira project from Jira Server into Jira Cloud:

• Bulk download (export) the project's documents from Jira Server along with their metadata:

  • Log on to your Jira Server instance

  • Open the Jira project that you want to migrate

  • Click the Documents tab

  • Select all the folders and documents that you want to migrate

  • Click Bulk Operations > Download.

Open

The selected documents are downloaded in a ZIP archive that contains a metadata.csv file with the document's metadata (Title, Description, Current Revision, etc.). The downloaded ZIP archive preserves the folder's structure. The file names might be changed in order to preserve the unicity. The documents of type URL are included in the metadata.csv. The documents of type Wiki are not included. You can also download a single folder by clicking the Download option from its actions menu.

• Extract the ZIP archive on your local computer.

At this point, the export of the data from Jira Server is done. Proceed further with the data import into Jira Cloud:

• Make sure that the Documents app has been installed and configured, and you can access the Documents tab of the Jira project, where the data will be migrated.

• Download Bulk Documents Uploader on your local computer.

Open

• At Source CSV file, click ... and select the medata.csv file from the folder where you extracted the ZIP archive with the exported documents. Its content will be loaded in the DATA TO IMPORT table. Check for eventual errors in the MESSAGES field.

• At Destination folder's key, you have to enter the key (id) of the existing folder from Documents where the data will be migrated. To determine the key:

  • Log on to your Jira Cloud instance

  • Open the Jira project where you want to import the data.

  • Click the Documents tab

  • Navigate and locate the folder where the files will be uploaded

  • Note down its key.

• If you want to import the files in the project's root folder, hover the mouse over the [Project Root] in the navigation bar. Its key will be displayed in a tooltip.

• At What to Import, make sure that Import folders, Import files and Import URLs are all checked.

• Click Start.... The "Jira Connection Settings" dialog will appear. Enter the information required by the app to connect to your Jira Cloud instance:

  • At Jira Base URL, enter the base URL of your Jira Cloud instance in form of "https://myjira.atlassian.net".

  • At Your Email, enter the email address of your Jira Cloud account.

  • At API Token you must enter a valid API token. Use the link offered in the dialog box to generate an API token. You can revoke the generated token after you finish importing the data.

  • Click Test Connection to validate the provided connection info. If the test fails, please double-check the info provided and try again.

• Click OK in the "Jira Connection Settings" dialog to continue the import process.

• The app is trying to connect to your Jira Cloud instance to check if the destination folder exists. If it exists, a confirmation dialog will pop up.

• Click OK in the confirmation dialog to start the import. The app will proceed with the import of the documents, starting with the folders.

• Check for any errors in the MESSAGES field. When it is done, check the content of the destination folder from Jira Cloud; it should display the migrated documents.

Repeat these steps for the others Jira projects that you want to migrate.