Migration methods

The Smart Attachments app supports data migration through Jira Cloud Migration Assistant only. Import of the XML backup file will not migrate the Smart Attachments data to Cloud.

Functionality migration specifics

This page shows what features of the Smart Attachments app can be migrated from the Server / Data Center to Cloud.

FunctionalityCan be migrated to CloudSpecifics of migration
Category attribution(tick)
  • In Jira Cloud, the app does not use categories, while it uses labels instead. They provide more flexibility.
  • During migration, the category attribution is converted into the label attribution. You can further group attachments by labels.
  • Note that attachments from the default Uncategorized category (even if it's renamed in your instance) won't have any labels on Jira Cloud after migration.
Global access restrictions(error)Unavailable in the Cloud app due to technical limitations of Jira Cloud.
Status-specific access restrictions(error)Unavailable in the Cloud app due to technical limitations of Jira Cloud.
Document revisions(error)Document revisions are grouped automatically if their names are matching.
Post-functions(error)You will have to add a post-function manually.
Validators(error)You will have to add a validator manually.
Conditions(error)

If you need any feature from the Server/DC version of Smart Attachments, please submit your request.

Pre-migration checklist

  • The Smart Attachments for Jira app migrates only the data for the projects available in Jira Cloud. You need to migrate the app simultaneously with Jira projects.
  • Note that attachments from the default Uncategorized category (even if it's renamed in your instance) won't have any labels on Jira Cloud after migration.
  • The app matches categories based on their names to avoid duplicated labels after migration. This logic is not case-sensitive, and the method trim() to avoid of duplicates in case of spaces before or after the category name. Please ensure that you have no typos or additional spaces between category names to avoid unrequited duplicated labels on Cloud.

The Uncategorized category is the default category of our app that is used for all the attachments that have not been placed by users into any other category. For example, once you start with our app, all the attachments are in the Uncategorized category. This category can't be deleted in any scheme. It can only be renamed.

The app behavior is different on Cloud. Due to the architectural limitations we don't have attachment categories. We introduced attachment labels instead. It means that ,after migration, the attachments get the labels corresponding to the category names they had on Server. This is true for all the categories but for the Uncategorized category as this is the default category for attachments that have not been categorized by the user. Thus, the attachments from this default category are migrated to Cloud without labels.

If that's critical for you, consider creation of a new category in the category scheme and moving attachments from the default category to this new category before migration.

  1. The latest version of the Smart Attachments for Jira Cloud is installed. There is no pending update.
  2. Smart Attachments 2.12.0 or newer is installed on your Jira Server / Data Center.
  3. The latest version of Jira Cloud Migration Assistant is installed on your Jira Server / Data Center.