---
title: "Maintain reusable document properties"
description: "Find, fill in and correct the shared values, such as the company name or the quality manager, that document tokens and AI document generation use across your organisation."
url: https://helpcenter.complytrain.net/en/articles/17-maintain-reusable-document-properties
collection: "Documents and knowledge"
updated: 2026-09-22
language: en
---

# Maintain reusable document properties

Find, fill in and correct the shared values, such as the company name or the quality manager, that document tokens and AI document generation use across your organisation.

Find, fill in and correct the shared values, such as the company name or the quality manager, that document tokens and AI document generation use across your organisation.

A document property is a named value that documents share, such as your company's legal name, the quality manager or the certification body. Each property has a code, for example `company.name`, a display name and one value for the whole organisation. Document text refers to the code with a token such as `{{ company.name }}`, and ComplyTrain shows the current value wherever the token appears.

Keeping the values here correct means every document that uses them is correct too. When a person changes role, you update one value instead of editing every procedure that names them.

## Who maintains properties

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

Document property values are maintained by organisation **Admins** in **Settings**, on the **Document Properties** page. Everyone else can open the same page read-only, to look up the value a token will print; they don't see the edit and review controls. Values also appear where documents use them, for example in the QMS editor's **Properties** panel.

Authors can propose a new property from the QMS editor; see [document property tokens](https://help.complytrain.net/en/qms/document-property-tokens/). Administrators review those proposals on the same page.

## Where properties come from

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

Open **Settings**, then **Document Properties**. The page opens with **About Document Properties**, which explains that properties are structured values that AI agents substitute into document templates.

Properties arrive in two ways:

-   **System properties** are added when your organisation adopts a standard, or a risk methodology, whose document templates use them. They carry the **System** badge.
    
-   **Custom properties** are proposed by authors from the QMS editor and become active once an administrator approves them; see [review proposed properties](https://help.complytrain.net/en/settings/document-properties/#review-proposed-properties).
    

Until one of these has happened, the page shows **No Document Properties**: no properties have been provisioned for your organisation yet. Adopting a standard in QMS is the usual way to fill the list.

![The organisation has no document properties yet. The page explains why no editable values appear.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/AnOB1DYFeA0wC0lxBfIMtGljKYzvlnHM4N42uuHfKniPKeDqeHsnX7xYR9zkPrUbsVqAVDoFTA3.png "Recognise a provisioning prerequisite")

## Read the summary

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

The summary at the top counts all of your organisation's properties, whatever filters you apply below it.

<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>Figure</p></th><th colspan="1" rowspan="1"><p>Meaning</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Total Properties</strong></p></td><td colspan="1" rowspan="1"><p>All of your organisation's properties.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Defined</strong></p></td><td colspan="1" rowspan="1"><p>Properties that have a value.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Missing (System)</strong></p></td><td colspan="1" rowspan="1"><p>System properties without a value. Shown only when there are some. A document whose text uses one of these properties cannot be approved until the property has a value.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Not Set (Custom)</strong></p></td><td colspan="1" rowspan="1"><p>Custom properties without a value.</p></td></tr></tbody></table>

Start with **Missing (System)**: these are the values your standard's documents rely on.

## Find a property

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

The list groups properties by category, such as **Company**, **Compliance** or **Quality**. Each heading shows how many properties the group has on the current page, with **defined** and **missing** counts. Select a heading to collapse or expand the group.

Each property shows its display name, its code, its scope and, for system properties, the **System** badge. The description follows below the name, and the value, or **Not set**, is on the right. Long values are shortened in the list; the full value appears in the editor.

<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>Filter</p></th><th colspan="1" rowspan="1"><p>What it does</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Search by name, code, or value...</strong></p></td><td colspan="1" rowspan="1"><p>Shows properties whose name, code or value contains the text you type.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>All Categories</strong></p></td><td colspan="1" rowspan="1"><p>Limits the list to one category.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>All Scopes</strong></p></td><td colspan="1" rowspan="1"><p>Limits the list to one scope; see the next table.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Missing values only</strong></p></td><td colspan="1" rowspan="1"><p>Shows only properties without a value.</p></td></tr></tbody></table>

Active filters appear as chips under **Active filters:**. Remove one with its **×**, or choose **Clear all**. The line **Showing … of … properties** tells you which part of the result you are viewing. The list shows 50 properties at a time; use **Previous** and **Next** to move between pages.

<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>Scope</p></th><th colspan="1" rowspan="1"><p>Meaning</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Global</strong></p></td><td colspan="1" rowspan="1"><p>Defined once for use by any standard or template, such as the company name.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Standard-scoped</strong></p></td><td colspan="1" rowspan="1"><p>Defined for a particular standard.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Document-scoped</strong></p></td><td colspan="1" rowspan="1"><p>Defined for one document template.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Legacy</strong></p></td><td colspan="1" rowspan="1"><p>Defined before scopes were introduced.</p></td></tr></tbody></table>

The scope describes where the property's definition comes from. Whatever its scope, each property has one value for your organisation.

When an author chooses **Edit property** on a token in the QMS editor, this page opens with the search already set to that property's code. If exactly one property matches, its editor opens straight away.

## Change a value

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

1.  Find the property and select its row. The editor opens under it; any other open editor closes.
    
2.  Check the **Source** shown under the field.
    
3.  Enter the correct text in **Value**. Spaces at the start and end are removed when you save.
    
4.  Choose **Save**. **Cancel** closes the editor without saving.
    

ComplyTrain confirms **Property saved**, and the summary and list update. To remove a value, clear **Value** and save; the property shows **Not set** again.

<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>Source</p></th><th colspan="1" rowspan="1"><p>Meaning</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Manual</strong></p></td><td colspan="1" rowspan="1"><p>The value was typed in.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Fact Linked</strong></p></td><td colspan="1" rowspan="1"><p>The value was taken from an organisation fact.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Knowledge Linked</strong></p></td><td colspan="1" rowspan="1"><p>The value was taken from content in your knowledge base.</p></td></tr></tbody></table>

Saving a value here replaces the stored value and keeps the source label. If the property is **Fact Linked**, correct the organisation fact as well so that both say the same; see [organisation facts](https://help.complytrain.net/en/tenant-context/maintain-profile-facts/).

## Review proposed properties

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

A property that an author proposes from the QMS editor starts as a proposal. It is not active: its token does not resolve and it cannot be chosen for other documents until an administrator has reviewed it on **Document Properties**.

1.  Find the proposal on **Document Properties**.
    
2.  Read its code, display name, category, description, suggested value and the author's reason for proposing it.
    
3.  Check that no existing property already covers the same information. Two codes for one fact lead to documents that disagree.
    
4.  Approve the proposal to make the property active, or reject it and give the reason.
    

An approved property becomes an active custom property with its suggested value, and it appears in the list with the other properties. Tokens that refer to it resolve wherever it has a value. A rejected proposal never becomes active; the author can use an existing property or propose a better one.

## Handle a version conflict

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

If someone else saved the same property after you loaded the page, **Version Conflict** appears: **This property was modified by another user. Refresh the page to load the latest version.** Choose **Refresh** to reload the list, read the value the other person saved, and decide whether your change is still needed before you edit it again.

If saving fails for another reason, **Save Failed** appears with the reason. The value is not saved; correct the problem and save again.

## Where values are used

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

<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>Place</p></th><th colspan="1" rowspan="1"><p>How the value is used</p></th></tr><tr><td colspan="1" rowspan="1"><p>QMS document editor</p></td><td colspan="1" rowspan="1"><p>A token in the text shows the property's value. The <strong>Properties</strong> panel counts resolved and unresolved tokens; see <a target="_blank" rel="noopener noreferrer nofollow" class="linktype-link link" data-linktype="link" href="https://help.complytrain.net/en/qms/document-property-tokens/">document property tokens</a>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>QMS approval</p></td><td colspan="1" rowspan="1"><p>A document whose text contains a token without a value fails the <strong>No unresolved properties</strong> check and cannot be approved; see <a target="_blank" rel="noopener noreferrer nofollow" class="linktype-link link" data-linktype="link" href="https://help.complytrain.net/en/qms/publish-approve-revise/">publishing and approval</a>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Exported and published QMS files</p></td><td colspan="1" rowspan="1"><p>The token is replaced by the value at the moment the file is produced. A token without a value is printed as its code in square brackets, such as <code>[company.review_owner]</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Tender response documents</p></td><td colspan="1" rowspan="1"><p>Tokens in a tender response are replaced by the values when the response document is produced, in the same way as QMS files, so bids carry the same company facts as your controlled documents.</p></td></tr><tr><td colspan="1" rowspan="1"><p>AI document generation</p></td><td colspan="1" rowspan="1"><p>AI agents that write document content use the values and insert tokens that refer to them.</p></td></tr></tbody></table>

## Effect on approved documents

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

A document stores the token, not the value. When you change a value:

-   Files already downloaded and versions already published to the vault do not change.
    
-   The editor, and every export or publication from then on, shows the new value, including for documents that are already approved.
    

Before changing a value that appears in controlled documents, decide whether those documents need a new version. For example, publish a revision of an approved procedure so that the vault holds a version with the new name.

## Example: a new quality manager

Product location: `/settings/document-properties`. Open Settings, then Document Properties.

Jordan Lee takes over as quality manager from Sam Patel, and your procedures name the quality manager through the `company.quality_manager` property.

1.  Open **Settings**, then **Document Properties**, and search for `quality_manager`.
    
2.  Select **Quality Manager**. Its **Source** is **Manual** and its value is `Sam Patel`.
    
3.  Replace the value with `Jordan Lee` and choose **Save**.
    
4.  Open one of the procedures in the QMS editor and check that the token now shows Jordan Lee.
    
5.  For each approved procedure that names the quality manager, publish a revision so that the controlled version in the vault carries the new name.
