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

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

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

Usability and Readability of Content Heavy Confluence Pages


Background: I am senior technical writer with a background in Instructional Design, an innate dislike of scrolling, and perchance for creating knowledge nuggets.

Challenge: I have find myself, as a new Confluence User, struggling with how best deal with content-heavy legacy pages. I would be very interested in how others have dealt with this challenge.

Case in point: A page that contains an ever-growing list of code blocks. The code macro was used, there is a TOC, but you could scroll forever. The page layout is in one block. I have been told that nesting code blocks into tables didn't really work.

If I was using OneNote or a regular publishing environment, even SharePoint, I could easily create a subpage, subfolder etc.  But I aim struggling as I learn Confluence to find an efficient approach to my challenge. 

I think, given my current level of Confluence knowledge, that my best option is to start by creating child pages based upon the current TOC. But I am challenged as to how to do this easily, even some of the sections contain a large number of code block macros.

Another aspect that will hopefully address the scrolling issue is to change the child page layout to a two or three column version style might be useful.

Would love to hear from folks who have this same challenge, and have hopefully prevailed. 



On a "heavy" page, select the stuff you want to move to a "sub page", click "create", (ideally, select a template that has a two or three column layout), give it a name, then paste the content.  Save it, go back to the parent and remove the bit you just did.

Think about adding the "children" macro to the parent page so people can see where you've moved stuff to.

Ada Chen Atlassian Team Apr 04, 2018

Child pages and the Children macro are a great way to break up the content.

If you want to keep the content on the same page, and just hide it while you're scrolling, you can also use the Expand macro:

Hi Julie,

If you want to keep the content on a single page, but want to limit the scrolling, I'd also tend to use the Expand macro mentioned by Ada.

Alternatively you could also have a look at the Expando Macro, which basically does the same as the Expand macro, but on heading level - if you enter an Expando Macro to a H1 element for example, all content will automatically collapsed until the next H1 element.



Log in or Sign up to comment
Community showcase
Posted in Confluence Cloud

Please tell us how you use Confluence space settings

Hi there, a few of us at Atlassian would love to learn about how you use "space settings" functionality in Confluence. A facelift to the space settings is long overdue and we want to start with impro...

274 views 8 7
Join discussion

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