This article answers questions about considerations for the number of pages, versions, and documents you can have in a space. We'll also provide tips to help you maintain the performance of your Scroll Documents managed spaces.
How Many Pages and Versions Can I Have in a Space?
We'll discuss pages and versions together, as document versions are physical copies of your page trees.
There is no exact limit to the amount of pages you can manage, the performance depends on several factors, including your content (e.g., attachments, macros, page restrictions) and the capacity of your Confluence instance.
General performance recommendations:
-
Keep page count to only the necessary amount: Scroll Documents helps you manage documents ranging from a few pages up to very high volumes. To get the best speed, please note that copy actions (like saving a version or adding a translation) naturally take longer as your total page count grows. We recommend keeping the number of pages in your Working version (or any base version) to only the amount necessary to ensure the fastest performance.
-
Confluence general guidance: For optimal performance on Confluence Cloud, Atlassian recommends keeping fewer than ~50,000 pages per space. See: Best practices for a great page tree experience.
-
Create an archive space: If frequent releases cause the number of versions to increase and affect usability in your space, consider creating a separate space (name it "Archive" or similar). You can move the page trees of your older versions to the archive space using Confluence’s Move option. The document connection remains intact, however, ensure the same authors have access to both the source and archive spaces.
-
Prioritize space permissions over page restrictions: We recommend using space permissions for access control. Keep page-level restrictions to a minimum, as they slow down processes (like saving a version) and reduce your content overview. If necessary, use version restrictions for a better overview of what is restricted.
-
Optimize or remove attachments: Make it a habit to review the attachments in your page trees to see if you have any that can be removed because they are not used. Alternatively, if you can optimize their size or spread them out across more pages.
How Many Documents Can I Have in a Space?
The number of documents you can manage in a space is influenced by factors like the total page count (though there's no exact limit), the complexity of your content, how you manage restrictions, and your Confluence system's overall performance.
To maintain optimal page tree organization, search performance, and space speed, we recommend limiting the number of large documents to a single digit per space. However, there is no exact limit here either.
General performance recommendations:
-
For large, complex documents: If you maintain several large documents with frequent version releases (such as product documentation or handbooks), we recommend giving each document its own dedicated space. This approach makes space performance, page tree management, and searchability much easier to handle within the space.
-
For small documents: If you primarily manage many smaller documents (such as contracts or proposals with less frequent versioning), you can more easily keep your space performance running smoothly and navigation manageable, even with many separate documents in one space.