---
title: "Assessment Labels "
url: "https://clinicians.ultramed.co/en/article/assessment-labels-upgrade"
language: "en"
last_updated: "2026-09-02T09:11:24.132Z"
---

# Assessment Labels 

## **Assessment Labels**

Labels let your team categorise and organise assessments with custom names and colours. The feature is available for MPO Base and MPO+ tenants.

#### **For Label admins**

> You'll see the **Labels** section in the navigation if you have admin access for your service.

#### **Setting up labels**

Navigate to **Labels** in the sidebar to manage your service's label library.

**Creating a label**

1.  Click **Create label**.
2.  Enter a name (up to 50 characters).
3.  Choose a background colour from the palette — the text colour is automatically selected to keep things readable.
4.  Save. The label is immediately available for your team to use on assessments.

**Editing a label**

Click a label's name (or its edit action) to update its name or colour at any time. Changes apply everywhere the label is already in use.

**Archiving a label**

If a label is no longer needed, archive it. Archived labels:

-   Cannot be assigned to new assessments.
-   Still appear on any assessments they were previously assigned to, so historical records are preserved.
-   Can still be selected as a filter when searching through older assessments.
-   Can be unarchived at any time to make them available again.

#### **For Clinical Teams**

> You'll see label controls on an assessment if your service has labels set up.

#### **Using labels on an assessment**

Open any assessment and look for the **Labels** section in the header area.

**Assigning labels**

1.  Click **Add labels**
2.  A dropdown shows all active labels for your service — tick any that apply.
3.  Labels are saved immediately; no extra save step needed.
4.  To remove a label, open the same dropdown and untick it.

**Viewing labels**

-   The assessment header shows a collapsible summary of all assigned labels, each displayed as a coloured chip.
-   The assessments table includes a **Labels** column so you can see labels at a glance without opening each record.

**Filtering by label**

In the assessments table, use the **Labels** filter to narrow the list to one or more specific labels. Archived labels appear in the filter list marked as *(archived)* so you can still search historical records.

#### **Analytics API**

Labels are included in the **Analytics API v2.1** response. If you're pulling assessment data programmatically, pass the header `analytics-version: 2.1` on your request to receive a `labels` field on each assessment record.

```
"labels": ["Cardiology", "Urgent"]
```

Labels are only available on current assessments.

#### **PDF reports**

When a report is generated for an assessment, the assigned labels appear in the **report header** under a dedicated **Labels** field, listed as comma-separated values. If no labels have been assigned, the field shows a dash.

  

#### **At a glance**

| What you can do | Who can do it |
| --- | --- |
| Create, edit, archive, and unarchive labels | Label admin |
| Assign or remove labels on an assessment | Clinical team |
| View labels on assessments and in the table | All practitioners |
| Filter assessments by label | All practitioners |
| View labels in generated PDF reports | All practitioners |
| Access labels via Analytics API (v2.1) | API consumers |

* * *

#### Tags vs. Labels

**Tags** are designed to link to statuses and folders within the platform. In future, tags may be used to move patients automatically through their pathway, so they should reflect your workflow structure.

**Labels** are designed to provide additional information or useful context that doesn’t necessarily map to a specific status or folder.

This is how we envisage them working for you. That said, we don’t enforce a single way of working, and what counts as a tag vs. a label may vary between health organisations depending on your SOPs, local preferences and analytics setup. The key, as always, is that this feature works for you.

  

Please note, that labels feature is only available for MyPreOp Base and MyPreOp+.