/
How to Set Macro Parameter Information

How to Set Macro Parameter Information

Our app does not currently support selecting macro parameters and values directly from the UI. However, there are two easy ways to find this information:

1. View the Macro in a Page's Storage Format

You can examine the storage format of a Confluence page that already contains the macro:

Steps:

  • Open the page with the macro.

  • Click “...” → Advanced details → View Storage Format.

  • Locate the XML data for the macro.

Example:

<ac:structured-macro ac:name="toc-zone" ac:schema-version="1" data-layout="default" ac:local-id="3eed9ada-3e8a-4846-b586-27177f9610c9" ac:macro-id="8fcbb3e3138efa7a544de3520b712f3330d6b904f02d2b7c4a4844637ff5bb4e"> <ac:parameter ac:name="minLevel">1</ac:parameter> <ac:parameter ac:name="maxLevel">2</ac:parameter> <ac:parameter ac:name="outline">true</ac:parameter> <ac:parameter ac:name="indent">10px</ac:parameter> <ac:parameter ac:name="location">top</ac:parameter> <ac:parameter ac:name="type">flat</ac:parameter> <ac:rich-text-body> <h1>Heading testing text for example 1</h1> <p>Sample testing text for example Sample testing text for example. Sample testing text for example Sample testing text for example.Sample testing text for example Sample testing text for example.</p> </ac:rich-text-body> </ac:structured-macro>

  • "toc" is the Macro name to input in our app.

  • All <ac:parameter /> elements go into the Macro parameter field.

  • The <ac:rich-text-body /> element goes into the Macro rich text field.

2. Use the “Import Macro” Feature

If the macro is already present on a page, you can use the Import Macro function to automatically retrieve its details.

Steps:

2.1. Click the Import Macro button

image-20250518-133100.png

2.2. Enter a keyword to search for the page

Select the page containing the macro, then click Select page.

image-20250518-133411.png

Click Import Macro

image-20250518-133609.png

The macro fields will be automatically filled based on the selected macro.

image-20250518-133705.png

3. Create a Reusable Macro Reference Page

To save time, consider maintaining a dedicated page that contains commonly used macros.
You can then easily select and import from this page whenever needed.