Best Practices for Space Size

DarkSideMilk February 21, 2024

We are using Confluence for IT documentation and Jira for our IT project management.

We have created a unified hierarchy that we use in Jira by having 3 main categories (Infrastructure, Operations, and Services/Programs) that make up our 3 projects. We then break each one out using components giving us a relatively simple way to organize stories/tasks for the various things we manage. This has worked out pretty well and can tie into creating simple reports of related issues within confluence.

On our server instances we were breaking out the confluence spaces that match these at the component level, which made for a lot of spaces, but they were relatively smaller which made pdf export possible so that we can have an emergency copy of the documentation as part of our disaster recovery plan. We used the refined app to create a site map to make navigation easier.

Now moving to confluence cloud we're looking at how and if we need to re-organize things. The navigation of a lot of spaces like we have is a bit clunky, and the refined app involves creating a whole different website that doesn't support all our macros, so we're not sure that's a direction we want to stick with. 

We've considered creating just 3 spaces to match the 3 projects, which would sort of follow some of the best practice guides we've found on creating a space for each "project". However this will create HUGE spaces that would be 1000+ pages. We have one space for our core infrastructure (so there are other components still broken into other spaces) that is around 600 pages, doing a pdf export of it in cloud took 20 minutes and created a pdf over 1 GB (it also took a long time on the server instance), opening a 1 GB+ pdf can be problematic, and if we merge all our spaces to 1 larger space with a parent page for each component it will get even bigger and become a bigger and bigger issue. 

We realize we can create custom exports of individual trees, but at least on the confluence server side, we can't do that in an automated fashion. We create a pdf export using the confluence CLI add-on weekly via an automated task so that we always have a current export. If there's a way to do custom exports through the rest api or the confluence cli api then maybe we can figure out the giant spaces.

So we're hoping we're not the first people with this problem and someone can share some insight on how to break out the documentation in a way that's not too cumbersome to navigate and that will scale into a backup/disaster recovery solution with some ease.

1 answer

0 votes
Humashankar VJ
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
February 21, 2024

Hi @DarkSideMilk - The below link will help you a lot to optimize your requriement, i have referred a most to enhance:

Kindly take a look and let me know if this helps !!


Hope this helps

Thank you very much and have a fantastic day!
Warm regards

DarkSideMilk February 21, 2024

Thank you for the reply. We have already read through that get started guide as well as many other articles like

We are also already using the content archiving add-on, it is pretty great. We archived a lot of pages before we migrated into cloud.

I'm looking for how other people are managing this type of documentation in confluence and for any guidelines on how many pages or how deep a page tree can be before it starts being a problem with exporting and navigation.


Like # people like this
Aron Gombas _Midori_
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
February 21, 2024

@DarkSideMilk The Better Content Archiving app is available also on the Cloud. I think should be in your toolset on the Cloud, as well, to have control over your ever-growing content.

Also, as an alternative to the automatic PDF exports, you could try to generate a static website from the Confluence content using Scroll Viewport. As it creates a website, there is no gigabyte-sized files generated, and navigating a website consisting of pages is better than paging a 1000-page long PDF...

Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events