newbie: page tree confusion

I created a space and imported a Word document, choosing Import as a New Page, split on level 4 headings, and the Documentation theme. I got the TOC in the sidebar, but it was collapsed rather than expanded one leve.

I created another space and did the same thing, except choosing Replace Home, and got no TOC in the sidebar.

I deleted both spaces and tried the first approach again, still no TOC.


4 answers

1 accepted

0 votes
Accepted answer

I can't reproduce this, so I don't know what the problem was.

Regarding the collapsed/expanded question, I have found that when using pagetree (or the left panel navigation tree - perhaps one and the same), if I expand the tree to navigate down to a page I want to see, click on the page, and then return, the tree is collapsed. This can be very annoying when you are trying to view more than one page at a lower level. Is there a setting which controls this behavior? Unfortunately, Windows Explorer has trained me to expect the tree to remain expanded. It feels like I spend a lot of time expanding the tree, and then re-expanding the tree, and then... You probably get the idea.

Hallo Robert

I'm not sure what you mean when you say that the TOC in the sidebar was collapsed rather than expanded. But here's some information about where the pagetree gets its information, in case this helps.

The most likely cause of pages not appearing in the left-hand panel is that the pages in your space are not children of the space’s home page. Perhaps when you imported the Word doc with "Replace Home", Confluence did not reset the space's home page setting.

Each space has a single page designated as its “Home” page. The Documentation theme constructs the TOC from the pages that are child pages of the space’s home page. If your pages are at the same level as (i.e. siblings of) the space home page, they will not appear in the left-hand navigation bar.

More background: The theme uses the {pagetree} macro to produce the table of contents on the left. When you use the {pagetree} macro on a page, you can choose the top page to be displayed. The Documentation Theme chooses the space home page as the top page.

The fix: If this is the cause, then there are two ways to fix the problem:

  • You can change the designated space home page for the space. You need space administrator permissions. Go to “Space Admin” and select “Edit Space Details”.
  • Or you can drag and drop all your pages to make them children of the current home page. Go to “Browse”, “Pages” and click the “Tree” option.

I hope this helps!



I can't reproduce this, so I don't know what the problem was.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

979 views 51 8
Join discussion

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