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.

Custom colors

Override label colors with CSS hex values:

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.