Using the Jira Macro Repair

Still need help?

The Atlassian Community is here for you.

Ask the community


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


As part of importing a Confluence Cloud space from a different instance, the Jira Macro Repair feature will be used to properly map the Jira issues macro to the correct application link, ensuring that all the macros will correctly retrieve the Jira information.

(info) In order to manually access this feature, an administrator of Confluence can also access the site's administration (cog icon at the top right) and then, select Jira Macro Repair.

Understanding the Jira Macro Repair

Understanding the Jira Macro Repair is crucial prior to its usage since it will perform changes to the existing content and those can't be converted unless the space gets re-imported. Here are the keys factors about the repair function:

  • The feature will change the application link used for the existing macros corresponding to the Jira instance connected to the source Confluence where the import came from. All content such as issue key, project and columns to be displayed will not change.
  • The left side (Existing Jira instance link) will correspond to the application link's name from the Jira instance connected to the source Confluence instance.
  • The right side (New Jira instance link) will correspond to the existing application links configured in the target/current Confluence instance to which the content has been imported.
  • If the Jira content has not been imported, the Jira issues will not be located at the target's Jira instance linked to Confluence, meaning that they can be only "repaired" if an application link is created to the source where the Confluence import came from and then, the remap would be performed.
  • If the issues are being imported via CSV to an existing Jira project, as it will create different issue keys, creating a new application link would be the best method to directly link it with the ID found in the instance where it is coming from. Otherwise, it would be needed to manually change the issue key used to the new one that is retrieved in the CSV.

Using the Jira Macro Repair

When Jira macros are pointing to a different application link after an import, the option to use the Jira Macro Repair will automatically be displayed as part of the process. To manually do it, the following steps can be performed:

  1. Go to Confluence's administration (cog icon at the top right) and select Jira Macro Repair

  2. Tap the Start button
  3. When there are Jira issues macro to be fixed, a pop-up will be displayed, stating that "We've found some broken Jira issue macros on your instance":
  4. Tap the Click here to fix button.
  5. If you have only a single application link, tap the Finish button to perform the repair. If there are different application links connected, tap the Select an Application Link dropdown in order to confirm the correct one and tap Finish.

When application links have the same name in both target and source instances, refer to How to check which application link the Jira Macro repair should be mapped after an import for a workaround.

Last modified on Sep 3, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.