How to Migrate from Dynamic to Static User Macros

To convert user macros currently implemented as dynamic to static, follow one of the two methods described below. These approaches ensure that previously added macros on Confluence pages continue to function without manual updates.

Option 1: Export, Edit, and Reimport

1. Exporting
   Go to the Admin page → Select a macro or macros → Export.
   

   

2. Editing
   Open the JSON file and locate the "macroType" field.
   Change its value from:

   "macroType": "dynamic"

   to:

   "macroType": "static"

3. Deleting
   Go back to the Admin page and delete the original macro or macros.

4. Importing
   Import the updated JSON file.
   During import, select Keep original macro key.
   This ensures existing pages using the macro won't break.
   

   

---

Option 2: Duplicate and Replace

1. Copy and edit the macro
   On the Admin page, click Copy in Actions.

2. Edit the name and key
   Update both to match the original macro's name and key.
   

   

3. Delete the original macro
   Before saving, delete the original macro in a separate tab.
   Confluence doesn't allow duplicate names or keys.

4. Save the new static macro
   After deletion, return to the edited copy and click Save.
   Your static macro now replaces the original, keeping its references.

{"timestamp":1792799573888,"msg":"A unknown Exception Occurred","errorMsg":"The provided AtlassianHostUser did not specify a user to act as.","code":"500"}