File & metadata storage

All the documents and folders created in the Documents app are stored as Jira issues in a dedicated Jira team-managed private project (aka "app repository"), which must be configured in a certain way by the Jira administrator during the app's post-installation steps (see “Configuring the app repository” in section). The files uploaded are stored as attachments to these issues, while the metadata is stored in the specific Jira custom fields of the repository next-gen project.

Backing-up the repository project assures the backup of all the documents from the entire Jira Cloud instance, which includes attachments and metadata.

VERY IMPORTANT!

  • Do not modify the issue types or the field configuration of this project because this might affect the app's functionality.

  • Do not manually create, delete or modify the issues of this project because this can cause invalid app repository data.

  • Ensure that regular users do not have access to the repository project.

  • Do not delete this project. Deleting the project will cause the entire Documents data to be lost from the Jira Cloud instance.