Macro Parameters: structured-macro, schema-version, macro-id

Hoping someone could explain (or link to documentation) regarding macro parameters: "structured-macro", "schema-version", and "macro-id".

The reason I ask is that I'm calling another (add-on) macro from a User Macro I'm creating.  I can either copy the source generated when using the add-on macro on a random Confluence page to get something like the following:

<ac:structured-macro ac:name="add-page-form" ac:schema-version="1" ac:macro-id="75223kksof-a39c5aXyz">

Or, I can just manually enter:

<ac:macro ac:name="add-page-form">

Both seem to achieve the same result (i.e. both appear to work).  Obviously, I'd prefer to use the 2nd as it's much simpler.  But I want to check that I'm not creating problems by:

  1. Using "ac:macro" instead of "ac:structured-macro"
  2. Ommitting the "ac:schema-version" and "ac:macro-id"

Any input/advice much appreciated!  Thanks in advance...

1 answer


I still have not been able to identify any functional difference between the two ways to code a macro.

Can assume that it's safe to use the second code (i.e. use "ac:macro" instead of "ac:structured-macro", and omit the "ac:schema-version" and "ac:macro-id")?

And, if it's safe to do so, can anyone (just for my own interest), explain what "structured-macro", "schema-version", and "macro-id" are for?


Suggest an answer

Log in or Sign up to answer
Community showcase
Published Friday in Agile

Are you a Jira Service Desk agent? We want to talk to you!

Are you a whiz at handling tickets and looking at how you can further optimize your workflow with automation? Do you tackle detailed customer support questions while simultaneously getting flooded wi...

94 views 0 5
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you