---
title: "Build the section structure of a blank QMS document"
description: "Create and maintain document sections, choose content types, organise children, edit properties and review deletion and requirement coverage."
url: https://helpcenter.complytrain.net/en/articles/45-build-the-section-structure-of-a-blank-qms-document
collection: "Documents"
updated: 2026-09-22
language: en
---

# Build the section structure of a blank QMS document

Create and maintain document sections, choose content types, organise children, edit properties and review deletion and requirement coverage.

Create and maintain document sections, choose content types, organise children, edit properties and review deletion and requirement coverage.

## Open the blank document and identify the controls

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Select Sections; hover over a section row to reveal its actions.

Create a blank document with the [QMS document wizard](https://help.complytrain.net/en/qms/create-document-wizard/), then open its detail page and select **Sections**. Check the document title and code before making changes. You need **View documents** to read it and **Manage documents** to change its structure. For an approved, locked document, start a [controlled revision](https://help.complytrain.net/en/qms/publish-approve-revise/).

An empty document offers **Add First Section**. Once sections exist, use **Add Section** to add another root. Expand a parent with its chevron to see its children. Select a section's name to read it; hover over its row to reveal **Add child section**, **Edit section properties**, **Delete section** and **Edit content in editor**. Diagram sections have their own editing action.

These actions build the structure of the document you opened. A document created from a template can also need its own additional sections; work from that document's Sections tab to change its structure. Reusable template authoring is a separate activity.

## Open a specific section from a link

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Use the section-specific URL when its document-section ID is known; otherwise select the section in the document tree.

Use the section-specific Product location with the document's standard code, document ID and **document-section ID**. The section ID identifies the saved section record; it is different from its displayed code, heading and template identifier. Resolve the relative address within your organisation's ComplyTrain site.

The link selects **Sections** and opens the section in view mode. Check its name, purpose, type, Required or Optional flag and content before choosing an editing action. **Edit content**, **Properties** and **Manage requirements** lead to different tasks.

If you do not have the identifiers, open the document library and select the document, then the section. If an older link no longer identifies an available section, find the current section in the document tree. Access still depends on the signed-in user's permissions.

![The reader shows the selected section’s type, purpose and Optional setting, with separate content, properties and requirements actions.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/DSv9wjufpjtToHvsd8ergnVKFwruOHkleQysZhOut3hWMSUrKWdcgWLv6HWona20I03T7uMBbmD.png "A section link opens the reader")

## Add a root section

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Select Sections, then Add First Section or Add Section.

1.  Choose **Add First Section** or **Add Section**.
    
2.  Enter a unique **Section Code** and a clear **Section Name**. For example, use `1` and `Scope`.
    
3.  Leave **Parent Section** at **Root Level (No Parent)**.
    
4.  Choose the content type and complete the guidance fields below. Scroll within the panel to reach the lower fields.
    
5.  Choose **Create Section**. Wait for the save to finish, then check the new row and open it to confirm the saved details.
    

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Field</p></th><th colspan="1" rowspan="1"><p>What to enter</p></th><th colspan="1" rowspan="1"><p>Example</p></th></tr><tr><td colspan="1" rowspan="1"><p>Section Code</p></td><td colspan="1" rowspan="1"><p>A required, unique code within this document. Follow a consistent numbering or naming convention.</p></td><td colspan="1" rowspan="1"><p><code>1</code>, <code>4.2</code> or <code>INTRO</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Section Name</p></td><td colspan="1" rowspan="1"><p>The required heading readers will recognise.</p></td><td colspan="1" rowspan="1"><p><code>Scope</code> or <code>Records to retain</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Content Type</p></td><td colspan="1" rowspan="1"><p>The format that suits the information you will author.</p></td><td colspan="1" rowspan="1"><p>Text Content for a scope statement.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Parent Section</p></td><td colspan="1" rowspan="1"><p>Root Level for a top-level section, or the intended existing parent for a child.</p></td><td colspan="1" rowspan="1"><p>Scope as the parent of Records to retain.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Purpose</p></td><td colspan="1" rowspan="1"><p>Why the section exists and what it must explain.</p></td><td colspan="1" rowspan="1"><p>Describe which equipment and activities are covered.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Content Structure / Template</p></td><td colspan="1" rowspan="1"><p>Expected headings, fields or boilerplate for the author.</p></td><td colspan="1" rowspan="1"><p>Equipment identifier; verification date; result; reviewer.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Optional Section</p></td><td colspan="1" rowspan="1"><p>Whether the section is optional in this document's structure.</p></td><td colspan="1" rowspan="1"><p>An additional supporting example.</p></td></tr></tbody></table>

A new section can have saved properties and still be **Pending** with no authored content. Complete its text or diagram in the appropriate editor.

![Create Section separates content type, parent, purpose and structure. Scroll within the panel to reach the other fields.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/sJnpVnnuG6Y9cKGM8oA6PxmiungZUbszdf8yUV502e7wJJ87L8nMjjxdXmexKalcTnNF7mPbgna.png "Root section fields")![Scope is saved as a root section. Its content can be authored next.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/Hq3GDzINmZTprD1WJbGv81QPwbLGIXlbehBs8CHqAkB8aqh4GBGvoBbHbr4Lqx9HWRgJen9P1xh.png "Saved root section")

## Choose a content type and diagram category

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Choose Add Section and set Content Type. Diagram exposes Diagram Type.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Content Type</p></th><th colspan="1" rowspan="1"><p>Use it for</p></th></tr><tr><td colspan="1" rowspan="1"><p>Text Content</p></td><td colspan="1" rowspan="1"><p>Narrative such as scope, responsibilities and explanations.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Table / Matrix</p></td><td colspan="1" rowspan="1"><p>Information compared by row and column, such as responsibility assignments.</p></td></tr><tr><td colspan="1" rowspan="1"><p>List</p></td><td colspan="1" rowspan="1"><p>Items with no required sequence, such as records to retain.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Numbered List</p></td><td colspan="1" rowspan="1"><p>Steps whose order matters, such as a verification procedure.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Diagram</p></td><td colspan="1" rowspan="1"><p>A visual explanation, such as a process flow or organisation chart.</p></td></tr></tbody></table>

**Diagram** exposes **Diagram Type**: General Diagram, Process Flow, Org Chart, Risk Matrix, Network, Data Flow and Other / Blank Canvas. Choose the category that fits the intended visual, then create the section and open the [diagram editor](https://help.complytrain.net/en/qms/edit-document-diagrams/) to draw and save it.

Choose the content type for the material you intend to maintain. Selecting a type, a diagram category or an Optional flag creates structure; authoring and reviewing the content are subsequent steps.

![Process Flow is selected for a diagram section, with a purpose that describes the intended visual.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/jAxw2unPNfoia0VbhcwsSwyEOeGgExLQic2PbUVObpF5hkBMrzkSMyHRL36ZpyWfxbG8izJlsgp.png "Diagram category and purpose")

## Add a child section and check the hierarchy

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Select Sections, then use Add child section on the intended parent row.

1.  Find the intended parent and choose **Add child section** on its row.
    
2.  Check **Parent Section** and the suggested code. Under `1 — Scope`, a child might be `1.1 — Records to retain`.
    
3.  Enter the child's name, content type, purpose and structure, then choose **Create Section**.
    
4.  Expand the parent and confirm that the saved child appears beneath it. Open the child to check its properties.
    

You can also select the parent in the Create Section form. Use Root Level when the new section should be a sibling of the existing roots. Choose the relationship deliberately: a dotted code helps readers understand numbering, while Parent Section determines where the section belongs.

Keep the tree understandable. Use children to group related material under a meaningful heading, rather than making an unnecessarily deep outline. Review the codes together after adding several sections so references such as “see section 1.1” point to the intended content.

![Records to retain appears beneath Scope; the separate Verification flow section has Diagram and Optional badges.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/5h6GzgOk2hMtJBIOO3s6p5EhuqawuyxOh13QtvMJL8MgMYHdufcPQuDBCx561oJu3GcXu1Ewg2x.png "Saved root, child and temporary diagram")

## Separate purpose and structure from authored content

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Inspect the section and its content indicator; enter actual content through Edit content in editor.

For a **Records to retain** section, the Purpose could explain why a record is needed. Content Structure / Template could list equipment identifier, verification date, reference instrument, result and reviewer. The authored content then explains the actual recording and retention procedure.

Save the guidance fields and reopen Properties to check them. Use the reader to inspect the section's purpose and template guidance; use **Edit content in editor** to write the actual text. When updating guidance, check whether existing content also needs a corresponding revision.

The **Optional Section** flag describes the document structure. Decide applicable standard requirements through the document's requirement mappings and review process. A filled-in purpose or outline does not establish requirement coverage or completed work.

Continue with [editing and saving content](https://help.complytrain.net/en/qms/editor-save-content/), or use the [standard generation workflow](https://help.complytrain.net/en/qms/generate-standard-documents/) when you want assistance drafting empty sections. Review generated wording before accepting it.

## Correct a section code or required field

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Read field validation, check existing codes, and correct or cancel the form.

Read the validation shown beside the field or after a save attempt. Fill in the required code and name, keep entries within the limits displayed by the form, and check the existing tree if a code is already in use.

For example, if `1` already identifies Scope, give a new Responsibilities section its intended unused code. Changing only the name does not resolve a duplicate code. Keep the proposed code consistent with the rest of the document, then submit again and check the saved row. Choose **Cancel** to abandon the unsaved form.

## Edit section properties

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Choose Edit section properties, save the intended changes, then reopen to check them.

Select **Edit section properties** on the section row. Confirm the section identity, change the fields you intend to update and choose **Save Changes**. Reopen the section to check its code, name, content type, purpose, structure and Optional setting.

To remove optional guidance, clear the Purpose or Content Structure / Template field and save. For a diagram that should use the general category, select **General Diagram**. Check the result after reopening. Choose **Cancel** when you want to keep the previously saved properties.

Property changes and content edits serve different purposes. Renaming a section changes its heading; update any written references to the old name where appropriate. Changing its purpose or structure calls for a review of the authored content. Before changing an established text section to a diagram, review the existing material and decide how it should be represented in the new format.

## Delete a section with an explicit confirmation

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Use Delete section on the intended row and review the confirmation.

Open the section and inspect its content before deleting it. Review children and requirement mappings as well as the heading. Choose **Delete section** on the intended row, read the confirmation, then choose **Cancel** to keep it or **Delete** to remove it.

Deleting a local section removes its content. Direct children are retained under the deleted section's parent, or at root level when the deleted section was a root; their codes remain unchanged. Check the resulting tree and update references or numbering where needed.

If deletion would leave requirements without coverage, review the additional affected-requirements confirmation. Cancel to retain the section while arranging alternative coverage, or confirm only when that removal is intended. Afterwards, inspect the Requirements tab as well as the section tree.

For example, deleting an unused, empty Verification flow section should leave Scope and Records to retain in place. Check the saved document after the operation, including any children that moved and any affected requirement links.

![Read the content-removal confirmation before choosing Cancel or Delete.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/llR9YSeeG4bNIpN4DWxqrjG2KXhuKlIe1x9aURb6jxp8eBNUnZyH963HRRJ66VGZhfUq87DBHNz.png "Review section deletion")

## Check the result before authoring or approving

Product location: `/qms/{standardCode}/documents/{documentId}` (fallback: `/qms/standards`). Reload the document detail and review Sections and the content count.

Review the section tree from top to bottom: names and codes, hierarchy, content types and Optional settings. Open sections whose purpose or structure changed, and check the actual content separately. Confirm that saved changes remain after reopening the document.

An organised tree is the starting point for a usable document. Author the missing content, review its accuracy and requirement coverage, then follow [document review and approval](https://help.complytrain.net/en/qms/edit-review-export-documents/). Use the content count to find unfinished sections, alongside the review and approval status.

![Scope and its Records to retain child remain after the unused diagram is removed.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/pNWXd8QWWgiFupAQhzLx9wPSEsSW4N7M2oLjCeuV24J7QvERomBiptspECakdxtao6uYH2BdSK7.png "Retained structure after reload")
