Tags
Tags are color-coded labels that can be applied to task lists. They provide a flexible, flat grouping mechanism — a list can have multiple tags, and the same tag can be applied to many lists. Use tags instead of a strict project hierarchy to categorize and filter your work (e.g. “Project Alpha”, “Urgent”, “On Hold”).
Permissions
| Action | User | Admin / Team Admin | Root |
|---|---|---|---|
| View tags | ✓ | ✓ | ✓ |
| Create a new tag (inline) | ✓ | ✓ | ✓ |
| Apply / remove tags from a list | ✓ (own lists only) | ✓ | ✓ |
| Rename an existing tag | — | ✓ | ✓ |
| Delete an existing tag | — | ✓ | ✓ |
Members with a custom role that includes tag management access can also rename and delete tags.
Note: Tags are scoped to the account. All members of an account share the same tag library.
How it works
Creating tags
Tags can be created in two places:
- Inline from a task list form — Open the Create list or Edit list modal and use the Tags field. Type a name and select Create “name” from the dropdown. You will be prompted to pick a color from the predefined palette before the tag is saved.
- From the Tag Management page — Admin and Root can tap the New Tag button (desktop toolbar) or the + FAB (mobile) to create a tag directly without needing to open a task list.
If a tag with the same name already exists in the account, the existing tag is reused — no duplicate is created.
Applying tags to a list
Open the Create list or Edit list modal and use the Tags field. Start typing to filter existing account tags, then select one to add it. Selected tags appear as colored chips above the input and can be removed with the × button.
Tag colors
Tags use a predefined palette of 12 colors (Red, Orange, Amber, Yellow, Green, Teal, Blue, Indigo, Purple, Pink, Rose, Gray). This palette is fixed and cannot be changed to custom hex values.
Filtering by tag
On the Task Lists page, a row of tag chips appears below the search bar. Click a chip to filter the list to all lists tagged with that label. Click multiple chips to see lists matching any of the selected tags (OR logic). A Clear button appears when one or more filters are active.
Searching tags (management page)
The Tag Management page includes a search field. Type to filter the tag list by name in real time. The list paginates automatically as you scroll — all matching tags load via infinite scroll.
Renaming and deleting tags (Admin / Root only)
Admin and Root can rename or delete any tag from the Tags management page (/app/tasks/tags), accessible via the Tags link in the sidebar. Each tag shows a count of how many lists it is currently applied to.
- Rename — tap the pencil icon on any tag row to open the edit modal. You can change both the name and color. The update takes effect everywhere immediately.
- Delete — tap the trash icon and confirm the alert. The tag is removed from all task lists automatically; the lists themselves are not deleted. This action cannot be undone.
Support notes
- Tag filter shows no results — The OR filter shows lists that have at least one of the selected tags. If a list has no tags at all it will never appear in a tag-filtered view.
- User cannot delete a tag — Tag deletion is Admin and Root only (or a custom role with tag management access). A User can remove a tag from their own list (via edit) but cannot remove the tag from the account tag library.
- Duplicate tag names — The system prevents creating two tags with the same name in an account. If a user tries to create a tag and a match already exists (case-insensitive), the existing tag is returned silently.
- Deleted list, tag still exists — Tags are independent of lists. Deleting a list does not delete its tags; the account tag library is unaffected.