Creating a document allows you to define a tree of Confluence pages as a single unit of content, letting you read, manage, and work on your multi-page documents in one view and stay in context.

In Scroll Documents, there are two methods of creating new documents:

  • Create a document from an existing set of pages in the Confluence page tree. You should do this when you already have a related set of pages, and you want to start managing them as a single unit of content.
  • Create a new blank document, comprising a new single blank page. This is for when you are going to author a new multi-page document in Confluence from scratch, and you want to take advantage of Scroll Documents' document management features.

Create a document from an existing set of pages 

Firstly, decide which page should be the root page of the document – this page is the parent of all the document's other pages. Everything nested below this page will be defined as a part of the document.

To create the document, navigate to the document root page, open the Document toolbox located at the top of the page between the watch and share icon. Click Convert to document to start managing this page and its children as a document. 


In the Create new document dialogue, you will add your document metadata: 

  1. Start by naming your document. By default this is the name of the root page, but you can also give your document a unique name. 
  2. Optionally add document labels which offer flexibility for categorizing and filtering the documents in your space. Note that the document labels are not the same as Confluence page labels.
  3. Optionally add a document summary to help you and other users know what this document is about without having to open or read each individual page. 

When you've finished adding your metadata, click Create. 

Once the document has been created, it will appear in your Documents library.  


Create a new blank document 

Depending on your workflow, you may want to create a new document from scratch. This video tutorial will show you how you can create a new document and assemble content from existing pages into your document: 

Navigate to the Documents Library by selecting the Documents library space sidebar item, then click New Document in the top right-hand corner:


Select Blank document from the create wizard and click Next.

In the next step, you will add your document metadata: 

  1. Start by giving your new document a name. This name will also be the name of your document root page, so be sure to give it a unique name in that space to avoid page title conflicts. 
  2. Optionally add document labels which offer flexibility for categorizing and filtering the documents in your space. Note that the document labels are not the same as Confluence page labels.
  3. Optionally add a document summary to help you and other users know what this document is about without having to open or read each individual page. 

When you've finished adding your metadata, click Create. 


Once the document has been created, it will appear as a Document card in your Document Library


Add pages to structure your document

From the Document Library, click the actions menu  in the right corner of the document card and select Open in page tree. This will take you to the page tree of your document.

At this point, your document consists of a single Confluence page. With the Document Composer, you can now easily add pages to your document in bulk. Open the Document toolbox located at the top of the page and click Compose.

Hover on the page in the page tree preview on the right where you wish to add a new blank page and then click the blue '+' sign.  Then, enter a page title in the text box that appears and press enter to add the page to your document.

image2020-2-7_10-50-18.png

To reorder a page in the outline, select and drag the page to move it to a new position. The blue bars will indicate the position that the page will be placed in the hierarchy. 

Note that the level of the page in the hierarchy will determine the heading level in the Scroll Document reader and export.

image2020-2-7_10-36-54.png

Once you click 'save', the pages are added to your document.

With the structure of your document in place, you can start adding content to the document. Learn more about how to Edit a document

You can find the root page of your new document located under the Documents parent page in the page tree: