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

Nesting one expand macro in another

I am attempting to use an expand macro inside another expand macro and according to this page, it is supposed to work. Anyone have a solution?


NOTE: I am attempting this on the new Confluence Blank page.

9 answers

2 accepted

7 votes
Answer accepted
Avinoam Atlassian Team Aug 06, 2019

Hi @Trevor Edwards and @Sharon Helms ,

I'm a PM working on the new editor in Confluence Cloud. We're currently in the process of redesigning a new experience for the expand macro which will allow it to both nest and work seamlessly on any device. 

We'll absolutely let you know once it's live!



Sharon Helms Community Leader Aug 06, 2019

Thanks, @Avinoam ! That's excellent news!

Like Trevor Edwards likes this

I am also looking forward to this!

Same, we are using it heavily and now it is broken with the new UI. Is there an ETA when it will work again?

Like Blue likes this

Happy New Year, @Avinoam

Any chance you've got some new updates for us in regards to this nested '/expand' functionality?  A number of us really rely on this and it's just making documents really sloppy and hard to read without it.  Even my scroll wheel is starting to wear out...  ;) 

Like Gary Haag likes this
Avinoam Atlassian Team Jan 06, 2020

Hi @Blue we recently released a new expand that also nests in table cells, however, it does not nest in other expands. You can read more about it here:

Like # people like this

Thanks @Avinoam , I think I've figured it out using the tables.  Much appreciated!

@Avinoam , will nested Expand macros be returning? The lack of this feature is making some complicated documents incredibly hard to read and is a massive omission!

Like # people like this

@Avinoam , I'm with @Stuart_Beck on this one - even trying to figure things out with tables, it's just not working and isn't a clean solution at all.  Right now we're having to change our layouts and hoping the nested /expand feature comes back soon.

Like Kim Miesse likes this

@Avinoam Any update on this nested expand feature? I was using it in the old editor as recently as two weeks ago, but have since been forced to auto-update editors and it appears as though I've lost access to the immensely valuable nested expand. A response would be much appreciated!

Like # people like this

It's frustrating how well designed features from prior versions are lost. I too would like nested expands like in prior versions of cloud and like how the self hosted version works. 

Like # people like this

Hi, just wondering if there is an ETA for being able to nest expands in Cloud soon? Love this in the legacy editor!

Also checking for an ETA on this. Using the table work around is really sub-par and much more time consuming. Thanks! 

Like Kim Miesse likes this

Now that we're in 2021, I wanted to make sure this got bumped to see if @Avinoam has any news or updates for us about this feature. I ran into this issue today, did some Googling, and ended up here to my dismay. Thank you!

Like # people like this

@Avinoam As a previous local server install preparing to switch to cloud, this makes me sad as i am severely missing this feature. :-(

Like chad nash likes this
Like chad nash likes this
Like # people like this
gil_haham I'm New Here Jul 12, 2021

Dear Atlassian,

The community is yelling for this feature.
Is it not so complex, most of the components needed are exist, I guess it is just a priority matter then.

Is it in the working plan? if so, what is the ETA?

Please do not ignore us.
@Sharon Helms 

Like Jaspal Sidhu likes this
0 votes
Answer accepted
Sharon Helms Community Leader Aug 06, 2019

Hi Trevor,

The doc you referenced (Cloud version) is from 2017 -- it used to be possible to next expand macros.

I'm guessing that you have the new Confluence editor active on your site? If so, that's why you can't nest one expand macro inside another.

I'm not sure if that functionality will be brought back. Fingers crossed!

+1 to fixing expand on new Confluence Cloud. There are issues with: 


  • Not able to embed one expand within another 
  • Not able to insert expand sections between bullet points. Screenshots below: 

Screen Shot 2019-12-13 at 9.11.47 am.pngScreen Shot 2019-12-13 at 9.11.54 am.png

2 votes
Cata AV I'm New Here Feb 06, 2021

Hellllo, can your designers bring the expland within and expand????? That was the main purpose of using Atlanssian..because it was easy to write and explain the documentation in very organized way...wth is that you have now...oh wait a new design and colors??? Never touch a functionality if your users are using it!

Thank you @Trevor Edwards for posing the question.


@Avinoam   ...I am also wondering, in the absence of being able to nest within a nest, is there an alternative or better way of doing what I am attempting to do.

I would like to show "years" then to be able to expand that and show "months" and be able to expand each day of the month to show accomplishments of that day.

As you can imagine, the will become quite lengthy if not able to nest them.

Thank you in advance.

1 vote
gil_haham I'm New Here Jul 12, 2021

Dear Atlassian,

The community is yelling for this feature.
Is it not so complex, most of the components needed are exist, I guess it is just a priority matter then.

Is it in the working plan? if so, what is the ETA?
Please do not ignore us.
2891 Views and still counting...

@Sharon Helms 

Thanks @Trevor Edwards  , for bringing this up, this was the exact question I had as well. I use the expand macro function in all my documents (and then create nested expand boxes).

@Avinoam , thank you so much for clarifying that this functionality will return in the new editor.

Why would you remove the ability to nest within nests it was by the far the single most useful feature confluence offered. The new UI change should only have been released if it actually added value. It does not you have made it look pretty but taken back critical functionality that made confluence a manageable space to log detailed workflows and documentation. The nests within nests also made embedding documents seamless without having pages that were 100 pages long. 


@Avinoam you promised last year this was being worked on yet instead more than 6 month later posted about table functionality that is clunky and doesn't solve the core problem.

You guys are building a product for Product owners how could you forget to identify the problem you are trying to solve when you released these tables? My concern is without this feature confluence will be largely redundant for anything other than minor workflows or analysis.

They said they are listening so everything should be fine :-)


It looks like I can use an Include Page macro inside an Expand macro. If the included page has expands on it, the effect is the same as nested expands.

That won't work for all use cases, but it might for some.

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! ...

518 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