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

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 Trusts 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+.