> For the complete documentation index, see [llms.txt](https://docs.truedat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truedat.io/administration/templates.md).

# Template management

Truedat includes an administration module for managing dynamic forms used by different document types. It allows administrators to customize fields displayed in different features. We call each form definition a **template**.

Templates can be defined for:

* [Business Glossary](/userguide/glossary.md): Each template in the Business Glossary scope defines a new business concept type. You can customize the concept types and fields documented for each. Examples include metrics, attributes, business terms, and policies.
* [Data Catalog](/userguide/catalog.md): Although connectors discover most Data Catalog information automatically, you can define additional information for manual documentation. Use templates with the Data Catalog scope.
* Quality Rules: Typically, use one template to define custom fields for Quality Rules. This supports your Quality Model. It lets you define Quality Principles, criticality, weight, or other attributes.
* Quality Implementations: Typically, use one template to define custom fields for quality implementations.
* [Quality Executions](/master.md): Define information used when manually requesting quality implementation executions. The quality engine may use this information, such as periodicity.
* [Grant request](/userguide/data-market.md): Define templates for requesting access to data.
* [Remediation plan](/userguide/quality.md): To add information such as a remediation plan to quality implementation results, define a template. It can include the plan name, implementation date, plan owner, and other relevant information.

## Template Management <a href="#id-2.4templatemanagement-templatemanagement" id="id-2.4templatemanagement-templatemanagement"></a>

Find this option in the administration panel. It includes a tab for each module that uses templates.

<figure><img src="/files/ghafdAuH8ryUQ7ZIG4A0" alt=""><figcaption></figcaption></figure>

To create a template, select **New template**. Complete the following form:

![](/files/xEbagzDLf4hsc4o1dDKh)

Common fields for all templates:

* **Name**: A unique application-wide code that identifies the template.
* **Label**: The template's display name. It appears when users select the template.
* **Scope**: The module where the template is used. Select one of the available options.
* **Subscope** (Business Glossary and Implementations only): Business concepts/Implementations using a template with a subscope appear in a separate menu after publication. The subscope becomes the menu name.<br>

Templates contain fields organized into groups. For long forms, define field groups to help users understand the document.

![](/files/-MSSOpuKfvCpElVhviXk)

The group name must be unique when saving the template. If there are groups with the same names, their fields will be merged into a single group.

Within each group, you can add fields and define their order.

Each field has the following options:

* **Label**: The text displayed for the field in the form.
* **Name**: A unique field code without spaces. You cannot modify this value after saving the template. Fields with the same name in other templates must have the same definition.
* **Description**: Optional. When set, a button appears in the form. Select it to view the description. <img src="/files/-MSSPn4aTKJdn4ZRKWEK" alt="" data-size="line">
* **Widget**: The component used to select the field value. See Widgets.
* **Type**: The field data type. Available types depend on the selected widget.
* **Cardinality**: Indicates whether the field accepts one or multiple values, and whether it is required:
  * **One or none**: An optional single value.
  * **One**: A required single value.
  * **None or more**: An optional list with multiple values.
  * **One or more**: A list with at least one value. Multiple values are allowed.
* **Editable**: When a field is non-editable, you cannot modify its value after completing the template.
* **Searchable**: All fields are searchable by default. Text searches look for matches in the field content. Disable this option to exclude the field from searches.
* **Values**: The values users can select. Options depend on the widget.
  * **Fixed list**: Add a list of possible field values.
  * **Key/Value list**: Define a saved code and displayed label for each value. You can change labels later without changing documents.
  * **Depending on another field**: Define a fixed list for each value of another template field. For example, the values available in a **Region** field can depend on the selected **Country**.\
    You can also define a default value based on the dependency field value.
  * **Dependent on domain:** Provide different possible values based on the domain selected for the concept, structure, quality rule, or quality implementation.
* **Default value:** For fixed-list or free-text values, enter a default value. The field is prepopulated when a document is created from the template.
* **Conditional visibility:** The field's visibility can depend on another field's value. This activates the field for specified values in a previous field.
* **Mandatory dependency:** The field can be required based on a previous field's value.
* **Subscribable**: When selected, this field can filter role-based subscriptions.

## Widgets <a href="#id-2.4templatemanagement-widgets" id="id-2.4templatemanagement-widgets"></a>

Widgets are components that you can select for a form. Each widget supports specific types, cardinalities, and values.

### Data entry widgets <a href="#id-2.4templatemanagement-widgetsforvaluesfreetext" id="id-2.4templatemanagement-widgetsforvaluesfreetext"></a>

| Widget / Example                                                    | Information                                                                                                                                                                                                                                                            |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](/files/3XyADKG1ktEEChykj2Ru)                                    | <p><strong>Type</strong>: String<br><strong>Cardinality</strong>: None (autogenerated)<br>This field is automatically populated with an autogenerated id that cannot be modified.</p>                                                                                  |
| ![](/files/-MSSUbdnu3ox-6nZqhGg)![](/files/-MKFpH5LAHRFHoKKokds)    | For single values, a standard input appears. For multiple values, press Enter to add each value.                                                                                                                                                                       |
| ![](/files/-MKFpH5NnAM8NxDK4Wms)                                    | Text input in a box.                                                                                                                                                                                                                                                   |
| ![](/files/-MKFpH5M3OIDHNWvJWUT)![](/files/-MKFpH5KcnJtP2xkdtle)    | Add link-and-value pairs. When viewing, select the displayed text button to open the link.                                                                                                                                                                             |
| <img src="/files/WnURYPzDEnq1aXDmZo5D" alt="" data-size="original"> | Enter rich text. You can underline, bold, italicize, create numbered or bulleted lists, and add web links.                                                                                                                                                             |
| ![](/files/-MKFpH5VF8CbDx8giOND)                                    | <p><strong>Type</strong>: Table</p><p><strong>Cardinality</strong>: One or none</p><p>Define a table for template users to complete. Specify the table columns. Cells accept text input only.</p>                                                                      |
| <img src="/files/UIyD8kljO4eQRRPj4pBd" alt="" data-size="original"> | <p><strong>Type</strong>: Dynamic Table</p><p><strong>Cardinality</strong>: One or none</p><p>Define a table for template users to complete. Specify columns and their content type: text input, user drop-down, user or group drop-down, or text-input drop-down.</p> |
| ![](/files/-MKFpH5atqugevdx6BzX)                                    | <p><strong>Type</strong>: Text string</p><p><strong>Cardinality</strong>: One or none / One / None or more / One or more</p><p>Masks a text field so its value is not displayed when users enter data or view the template.</p>                                        |
| ![](/files/-MSSYnmiaq_84JC-Pbn3)                                    | <p><strong>Type</strong></p><ul><li>Integer</li><li>Decimal</li></ul><p><strong>Cardinality</strong>: One or none / One</p><p>Displays a field that accepts numeric data only.</p>                                                                                     |
| ![](/files/-MSSZX51qQ95MSnCkk2n)                                    | <p><strong>Type</strong>: Date</p><p><strong>Cardinality</strong>: One or none / One</p><p>Displays a calendar widget for selecting a date.</p>                                                                                                                        |
| ![](/files/-MSSZVL9YAgpBNbMtsyp)                                    | <p><strong>Type</strong>: Date Time</p><p><strong>Cardinality</strong>: One or none / One</p><p>Displays a calendar widget for selecting a date and time.</p>                                                                                                          |

### Fixed value widgets <a href="#id-2.4templatemanagement-fixedvaluewidgets" id="id-2.4templatemanagement-fixedvaluewidgets"></a>

For **users or groups of users in a role**, the Type must be **`User`** or **`User or Group`**. For **Fixed list**, **Code / description list**, or **Depending on another field**, the Type must be **`String`**:

|                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](/files/-MKFpH5Ht1a0OaWUmE06)![](/files/ZCDCduK95Q5leETwa69E) | <p>Drop-down for selecting values.</p><p>You can choose:</p><ul><li>String</li><li>System</li><li>Domain</li><li>User</li><li>User or Group</li><li>Group</li><li>Hierarchy</li></ul><p>For <code>User</code>, <code>User or Group</code>, or <code>Group</code>, specify the role for the displayed user list.</p><p>For <code>Hierarchy</code>, select an available hierarchy and specify the minimum selectable level. The top level is <code>0</code> and allows any level.</p> |
| ![](/files/-MKFpH5GBDXtM3N3IST0)![](/files/-MKFpH5DmnzXmInFREd_) | <p>List for selecting one value.</p><p>You can choose:</p><ul><li>String</li><li>User</li><li>User or Group</li><li>Group</li></ul><p>For <code>User</code>, <code>User or Group</code>, or <code>Group</code>, specify the role for the displayed user list.</p>                                                                                                                                                                                                                   |
| ![](/files/-MKFpH5FYxn5LgY1_IfI)![](/files/-MKFpH5C91QJ1ck3OcZa) | <p>List for selecting multiple values.</p><p>You can choose:</p><ul><li>String</li><li>User</li><li>User or Group</li><li>Group</li></ul><p>For <code>User</code>, <code>User or Group</code>, or <code>Group</code>, specify the role for the displayed user list.</p>                                                                                                                                                                                                             |

### Special widgets <a href="#id-2.4templatemanagement-widgetsforothercases" id="id-2.4templatemanagement-widgetsforothercases"></a>

| Widget / Example                 | Description                                                                                                                                           |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](/files/-MKFpH5cMQqN-cz-dFhd) | <p><strong>Type</strong>: Image</p><p><strong>Cardinality</strong>: One or none / One</p><p>Allows you to attach an image up to 2 MB to the form.</p> |
