Macro Migration Tips

When you migrate from ScriptRunner for Confluence Server or Data Center to ScriptRunner for Confluence Cloud, macros are unsupported and need to be replaced with a supported Cloud macro. The three built-in macros that are supported by ScriptRunner for Confluence Cloud are: 

Is there a macro that you would like to see supported in Cloud? Do you have an idea for a new macro? We want to hear from you! Please forward your requests and ideas via our customer support portal

Insert the Cloud macro

If you see one of these notifiers, it means the old macro needs to be replaced with a Cloud macro. 

  1. Open the page that needs the macro updated. 
    The macros that need to be updated appear in yellow: 
  2. Select Edit ().
    This is the screen you see: 

  3. Decide if you want to convert to the new Confluence Cloud macro editor. 

    Converting to the new editor makes macro migrations easier because you can see the old field values and enter them into the new macro at the same time. In the legacy editor, you can view the old field values in view mode, note them, and then enter them into the new macro on a different screen. 


    • If you choose to use the legacy editor, follow these steps: 
      1. Select Close in the bottom right-hand corner of your screen to go back to view mode.
      2. For each macro, note your field values in the yellow sections. 
      3. Select Edit ().
      4. Insert a new macro on the page. 
        The supported Cloud macros have the same names:

        • Add Labels

        • Choose Label

        • Page Info

          If you need help with this step, check out the Macros documentation.

      5. Enter the field values in the new Cloud macro. 
      6. Save the Cloud macro. 
      7. Delete the old Server or Data Center macro.
    • If you choose to use the new macro editor, follow these steps: 
      1. Convert to the new editor by selecting Preview Page at the bottom left-hand corner of your screen.
      2. Follow the prompted steps.
      3. Insert a new macro on the page
        The supported Cloud macros have the same names:

        • Add Labels

        • Choose Label

        • Page Info

          If you need help with this step, check out the Macros documentation.

      4. Fill out the macro fields for the Cloud macro.
        Your old macro values appear in the yellow box. For example, this Page Info macro had the Current Version value for the Information Type field.  

      5. Save the Cloud macro. 
      6. Delete the old Server or Data Center macro.