Create labels
Owners and members with access to every surface manage labels under Settings → Labels.- Under New label, enter a Name, and optionally a Description.
- Choose a Color.
- Choose Create label.
Start from the suggested labels
A new workspace has no labels. Settings → Labels suggests a starter set that many teams already use: Content, Embed, Mobile, Plugin, Screen Reader, and Theme. Choose Add suggested labels to add the ones you don’t have yet. You can rename, recolor, or delete them afterward.Edit or delete a label
Each label in the list shows how many issues carry it, including resolved ones.- Choose Edit to change a label’s name, color, or description. The change shows on every issue that carries the label.
- Choose Delete to remove a label. Ility tells you how many issues will lose it before you confirm with Delete label. Deleting a label removes it from every issue.
Label an issue
Open an issue and find Labels in the sidebar.- Choose Add labels, or Edit labels if the issue already has some.
- Check each label you want and uncheck any you don’t. The menu stays open, so you can pick several in a row.
Filter by label
Labels show as chips on each issue in your issue lists.- On a surface’s issue list, choose Filter, then choose one or more labels under Label.
- On the workspace Issues page, choose labels in the toolbar.
Who can do what
Members limited to some surfaces can only label issues on the surfaces they can see. Viewers, including clients invited as viewers, can only see labels. A label’s issue count only includes issues you can see. See client access.
Use labels from the API and MCP
GET /v1/labelslists the workspace’s labels. To label an issue, send its full set of label ids aslabel_idstoPATCH /v1/issues/{id}.- Pass one or more
labelids toGET /v1/issuesto filter issues by label. - In the MCP server,
list_labelslists labels, andlist_issuestakes alabelfilter. You can ask your assistant something like “List the open issues labeled Theme.”