> For the complete documentation index, see [llms.txt](https://docs.request.biz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.request.biz/administrator-guide/data/codes.md).

# Codes

The **Data > Codes** section allows management of *codes* which are small sets of values that can be used to organize the different entities like templates, tasks, etc.

<div align="left"><figure><img src="https://2723114352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaBzbSV4obl284TJgE1Hg%2Fuploads%2F2KsMgKkku2EuHol4TYDK%2Fimage.png?alt=media&amp;token=215ff79d-688a-43d7-9789-fa8792403939" alt="" width="563"><figcaption></figcaption></figure></div>

## Editing a Code Type

Click on the tile of choice to edit the values.&#x20;

A new code can be added by clicking on the **Add New** button at the top left of the dialog:

<div align="left"><figure><img src="https://2723114352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaBzbSV4obl284TJgE1Hg%2Fuploads%2FlgM6qXDmSsnG0E39CcSu%2Fimage.png?alt=media&amp;token=e715575c-fbc4-4b25-85d1-8cee1a1b5aa9" alt="" width="354"><figcaption></figcaption></figure></div>

On the left-hand side of the dialog a *New Code* entry appears, and the right-hand pane is changed to display two data entry boxes, **Text** and **Description** where the name (and description) of the new category can be defined:

<div align="left"><figure><img src="https://2723114352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaBzbSV4obl284TJgE1Hg%2Fuploads%2FT9XL80yXUlfTJmaGqP8w%2Fimage.png?alt=media&amp;token=c1789af0-8d0e-4b0e-907c-cca0f564b2af" alt="" width="563"><figcaption></figcaption></figure></div>

After making your changes make sure to press the **Apply** button at the top right. To persist your changes press the **Save** button at the bottom of the dialog.&#x20;

## Supported Code Types

Currently the system supports the following code types:

<table><thead><tr><th width="190">Code Type</th><th>Description</th></tr></thead><tbody><tr><td><a href="#task-categories">Task Categories</a></td><td>Used by the <strong>Category</strong> property of a <strong>Task</strong> entity.</td></tr><tr><td><a href="#template-categories">Template Categories</a></td><td>Used by the <strong>Category</strong> property of a <strong>Template</strong> entity.</td></tr><tr><td><a href="#locations">Locations</a></td><td>Used by the <strong>Location</strong> property of several entities.</td></tr></tbody></table>

Note that some code types are represented as a hierarchical tree node list, while others are just a simple flat list.

### Task Categories

Clicking the **Task Categories** tile opens the following dialog:

<div align="left"><figure><img src="https://2723114352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaBzbSV4obl284TJgE1Hg%2Fuploads%2FujBl05X0Cv79OnviuxCj%2Fimage.png?alt=media&amp;token=679156a8-275c-4a73-9b49-34f01e733641" alt="" width="563"><figcaption></figcaption></figure></div>

Tasks can then be categorized by the assignee of the task choosing the most appropriate task category from the drop down list:

<div align="left"><figure><img src="https://2723114352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaBzbSV4obl284TJgE1Hg%2Fuploads%2FTbqZBFymMTgZO7uNsvv5%2Fimage.png?alt=media&amp;token=04df67e0-259b-4291-b277-b4db0e44a427" alt="" width="375"><figcaption></figcaption></figure></div>

Note that a task can also have multiple categories.

### Template Categories

Templates, when presented to the user, will be grouped by category. Typically, these categories will reflect the type of request being made, perhaps to *order a new product or service*, to *resolve an issue*, *ask a question*, etc.

<div align="left"><figure><img src="https://2723114352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaBzbSV4obl284TJgE1Hg%2Fuploads%2FbsdleJNOtqBvqIZmUo2L%2Fimage.png?alt=media&amp;token=0ddf1250-d2a6-4c74-9d71-d928a6b486d4" alt="" width="563"><figcaption></figcaption></figure></div>

By default, <code class="expression">space.vars.PRODUCT\_NAME</code> comes with the following predefined categories:

* *Ask*,&#x20;
* *Change*,&#x20;
* *Inform*,&#x20;
* *Order*,&#x20;
* *Resolve,*
* *Schedule*.&#x20;

For most tenants these categories should be sufficient. However, depending on your business requirments, the default categories can easily be added, changed or removed.

{% hint style="warning" %}
A category can only be deleted if it is not used by any [Templates](/administrator-guide/plans/templates.md) anymore. If a category is being used by one or more Templates the **Delete** button will be disabled.
{% endhint %}

The template category codes, either default or custom, can be assigned to <code class="expression">space.vars.PRODUCT\_NAME</code> [Templates](/administrator-guide/plans/templates.md), either at the time of their definition, or on subsequent editing. The category assignment will determine where the template will be visible to the end user.

Note that Template Categories can be structured into a parent/child hierarchy so that the user has a more organized view of the templates available for the various types of requests. Use drag and drop to move nodes to another parent node.

See [Editing a Template](/administrator-guide/plans/templates.md#editing-a-template) for more information about assigning a Template Category to a Template.

### Locations

Locations can associated with [User Groups](/administrator-guide/security/user-groups.md), and also, if [Microsoft Entra ID (MEID)](/administrator-guide/security/settings/microsoft-entra-id-meid.md) or [Active Directory Federation Services (ADFS)](/administrator-guide/security/settings/active-directory-federation-services-adfs.md) is used for access control, it is possible to control template access through [Roles/External Groups](/administrator-guide/security/roles.md#external-groups-optional) definitions.
