Labels

Labels let you categorize and filter issues. Use them for types (bug, feature), areas (frontend, backend), or anything else your team needs.

Add labels

xpo add "Feature" --label feature
xpo add "Critical bug" --label bug --label urgent
xpo update <id> --label bug

Labels are freeform strings — use whatever makes sense for your project.

Default labels

xpo ships with four built-in labels: bug, feature, epic, improvement. Customize them in config.yaml:

default_labels:
  - bug
  - feature
  - epic
  - improvement
  - chore
  - docs

These appear in the web board's label picker. Set hide_default_labels: true to hide the built-in set entirely.

The workflow uses the built-in labels to classify issues, so the board treats them as read-only: it won't rename, recolor, re-add or delete them, or rename another label onto one. Change them in config.yaml.

Custom colors

Pick a label's color in the Labels view, or set CSS hex values in config.yaml:

labels:
  bug: "#e11d48"
  feature: "#2563eb"
  epic: "#7c3aed"
  improvement: "#0891b2"

Filter by label

xpo list --label bug
xpo list --label feature

In the web board, click a label to filter the view. See Filters for combining label filters with other criteria.

In the web board

Press l on an issue (or click + next to its labels) to open the label picker. Type to filter, or pick Create "…" to create a new label and apply it in one step. New labels start uncolored; give them a color in the Labels view.

Labels