Display Linked Issues DC - Migrate to Cloud

The settings of Display Linked Issues for Jira Data Center move to Jira Cloud with the Jira Cloud Migration Assistant (JCMA), together with the Linked issues custom fields JCMA migrates. They arrive in Display Linked Issues (Forge) for Jira Cloud. Nothing leaves Atlassian.

Settings move only with a JCMA migration plan: there is no export file for Display Linked Issues.


Before you run the plan

  1. Update Display Linked Issues for Jira Data Center - the first Display Linked Issues Data Center version released after 3.4.0, or later.
  2. Install Display Linked Issues (Forge) in the cloud site.
  3. Put the Linked issues field on a screen of every project whose settings you want to migrate. JCMA carries over the projects of a field context only for the projects where the field is on a screen: for any other project the context arrives in the cloud without that project, and the configuration of the field for that project is placed on the global context.

What arrives in the cloud

Each configuration of a field context (see Field settings) becomes:

  • A configuration of the Linked issues field on the matching field context of the migrated field, named <field> (Data Center #<id>). A configuration limited to projects that have no context of the field in the cloud is placed on the global context, and its description says so.
  • A panel configuration, when Show as panel was on. A panel in the right column becomes Issue Context, a panel in the main column Issue Panel.
Setting In the cloud
Link direction Kept (inward, outward or both).
Link types Matched by name. A link type with no cloud type of the same name is named in the description.
JQL Copied as text: ids of Data Center projects and fields are not translated, and placeholders such as ${issue.key} have to be rewritten as cloud templates, for example {{ issue.key }}.
Fields (columns) System fields and fields migrated by JCMA, in the same order; otherwise Key, Summary and Status.
Max issues At most 1000; an empty value becomes 50.
Show count Not a limit in the cloud: the description says Show more after N rows: Cloud has no "Show more" and shows up to N linked issues.

Everything arrives disabled

Every migrated configuration is created disabled. Its description starts with Disabled after migration: ... and the reason or what to check. Review the configurations in Display Linked Issues settings in the cloud and enable them there.

  • Nothing is overwritten: if the field context already has a configuration in the cloud, the Data Center one is skipped.
  • Running the migration again creates no duplicates.

Not migrated

  • Sub-task and system links.
  • The panel on the agile board.
  • Include current issue.
  • Exact match by a field.
  • A custom panel Location - the panel is shown in Issue Panel.
  • The panel title - cloud panels have a fixed title.

Each one is named in the description of the configuration that used it and in the JCMA migration log.

In the cloud, linked issues are read as the viewing user: a viewer sees only the issues and fields they have access to.

Details of the cloud side - configurations on the global context and how to move them to the context of their projects - are in Migration from Data Center of the Forge edition.