When Does Scroll Documents Create New Confluence Pages Vs. Re-use Existing Pages?

Scroll Documents builds on trees of Confluence pages to define them as a single unit of content (a Scroll Document).

When using the features in Scroll Documents, most of the time, the page trees that Scroll Documents builds on are newly created by the app.

Only when you use the app option Use existing page tree/Enable Scroll Documents does the app take an already existing Confluence page tree to create the document (more specifically, to create the Working version). Deleting this document and its Working version might then also completely delete your original content.

Learn in full detail how and when Scroll Documents uses new or existing Confluence pages in your space to create documents and versions of documents. Find a detailed breakdown for all app actions in the tables below.

Instances Where Existing Confluence Pages Are Re-Used

Option in the app	What gets created
New document – > Use existing page tree In the Document Toolbox on Confluence pages this option is called Enable Scroll Documents	Scroll Documents will take an already existing page tree in your space to create the Working version of the document.

Be cautious when deleting Scroll Documents (and its Working versions) that were created with the Use existing page tree/Enable Scroll Documents option. If you tick the box “delete page tree” in the delete dialog, the app will also delete your originally created Confluence page tree. For further information, refer to Delete a Document and its Versions.

Instances Where New Confluence Pages Are Created

Option in the app	What gets created
New Document → Create new page tree	A new Confluence page, which: has no content (blank page) uses your Document Title (entered in Document Details) as the page title serves as the root page of your Working version page tree might have child pages if you choose to add these in the step Organize Page Tree
Organize Page Tree → Copy page	A copy of an existing page in Confluence
Organize Page Tree → Include page	A new Confluence page, which: contains only an include page macro (pointing to the page that was dragged over to the page tree)
Organize Page Tree → Add blank page	A new Confluence page, which: has no content (blank page) uses the title that you added to the field in the “Organize Page Tree” dialog as the Confluence page title
Save version	This action copies of all pages of an existing page tree (by default of the Working version of the document)
Copy version	This action copies all pages from a chosen version and add the copied pages to a new document.