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 Join to answer
Community showcase
Jason Wong
Published yesterday in Agility Beta

Welcome to agility

Every team in the world is unique, and so   Atlassian believes   that each and every team's best way of working  needs to  be molded to their unique circumstances  – ...

269 views 5 14
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot