All docs

Priority and labels

Mark how urgent a conversation is, colour-code topics with labels, then filter, sort and bulk-update the Desk list by them.

Updated . 3 min read.

Priority says how urgent a conversation is. Labels say what it is about. Both stay on the thread, show in the list, and work in filters, bulk actions and the API.

Set the priority

Above the thread, next to the subject, the Priority button shows the current level. Click it and choose Low, Normal, High or Urgent. New conversations start at Normal.

High and urgent conversations carry a coloured chip in the list so they stand out. If you use service levels with different targets per priority, a running timer follows the new priority: raising a conversation to urgent shortens its deadline right away.

Add labels

Click Add label (or Edit labels) above the thread and tick the labels that fit. Untick to remove one. The conversation shows each label as a small chip with its colour, and the list shows up to three per row.

Every change is written into the thread as a quiet line, for example "Anna Agent added the label Billing", so the whole team can see who did what.

Create and manage labels

Open Desk settings → Labels:

  • New label - pick a name (up to 64 characters, unique in your workspace) and a colour. Coral is the default.
  • Edit - rename or recolour. The label stays on every conversation that has it.
  • Delete - removes the label from every conversation, in the background. The conversations themselves are not touched.

The list shows how many conversations carry each label.

Tags and labels

Labels replace the free-text tags that earlier versions of Desk used. Every tag you already had became a label with a colour, so nothing was lost. Anything that still writes tags - imports, routing rules, the API's tags field - creates the matching label on its own and files the conversation under it.

Filter and sort the list

Click the search button next to Desk to open the filters:

  • Priority - show only one level.
  • Label - show conversations with that label.
  • Sort - newest activity (default), oldest activity, most urgent first, or waiting longest (the customer who has waited longest for an answer comes first).

Filters stay in the address bar, so you can bookmark a view such as "urgent conversations, waiting longest first".

Change many conversations at once

Hover a conversation and tick its checkbox. With something selected, the filter panel shows the bulk bar:

  • Assign to a teammate.
  • Set priority for the whole selection.
  • Add label to the whole selection.

From the API and MCP

Priority and labels are available everywhere the Desk is:

  • REST: PATCH /desk/threads/{thread} accepts priority and label_ids; GET /desk/threads filters with priority, label and sort; GET/POST/PATCH/DELETE /desk/labels manage labels. See the Response Desk API reference.
  • MCP: update_desk_thread, list_desk_threads, bulk_desk_threads and list_desk_labels, create_desk_label, update_desk_label, delete_desk_label.

Next