Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

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?


Is there someone who find the doc? The real one

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

🏑 Atlympic Event: Confluence

Hello Community!  Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...

493 views 18 17
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you