Tags

Lightweight org-scoped labels you can attach to feedback and roadmap posts for filtering and grouping.

Tags are short labels — typically a single word — that you attach to feedback or roadmap posts. They're useful for filtering ("show me everything tagged mobile") or for surfacing themes that don't deserve their own category.

The API lets you list, retrieve, and create tags. To add or remove a tag from a specific post, use the feedback post update endpoint.

Tags vs categories vs labels. Tags and categories are both for posts (feedback or roadmap) and are org-scoped. Tags are typically lightweight ad-hoc keywords; categories are higher-level taxonomies. Labels are a separate concept used by changelog entries.

The tag object

idstring

Required

A unique identifier for the tag (UUID).

namestring

Required

The display name of the tag.

codestring

Auto-generated slug-like identifier derived from the name. May be null.

colorstring

Optional hex color string for the tag's visual badge in the dashboard. May be null.

show_on_feedbackboolean

Required

Whether this tag appears in feedback views.

show_on_roadmapboolean

Required

Whether this tag appears in roadmap views.

created_atstring

Required

ISO 8601 timestamp at which the tag was created.

Example tag object

{
  "id": "773c3ef8-b8cd-cd15-01ba-tag00000001",
  "name": "mobile",
  "code": "mobile",
  "color": "#10B981",
  "show_on_feedback": true,
  "show_on_roadmap": true,
  "created_at": "2026-04-12T08:30:11.000Z"
}

What you can do

Retrieve a tag

Look up a single tag by its UUID.

List tags

Return every active tag for the authenticated organization.

Create a tag

Add a new tag the dashboard and the API can apply to posts.

Was this page helpful?

Last updated 1 week ago

Built with Documentation.AI