# Work-Item Types

> Per-workspace Type catalog for features: Feature, Bug, Tech-Debt by default. Add, recolor, reorder, set the default, choose which types reach the roadmap, archive.

Source: https://productos.ca/documentation/pages/settings/work-item-types (last reviewed 2026-09-22)

Work-Item Types make features usable as dev work items: every feature carries a **Type** (`features.type_id` → `work_item_types`) alongside its status. The catalog is **workspace-scoped**: each workspace defines its own taxonomy here.

Members, admins and owners can manage it; commenters and viewers see a Locked panel.

## Defaults

Every workspace is seeded with three types (at provisioning, so they exist before the first feature):

- **Feature**: the default for new features; the only type flagged for the roadmap
- **Bug**
- **Tech-Debt**

Add more (Chore, Spike, Hotfix, …) with the **Add type** field.

## What you can do per type

- **Recolor**: pick from the design-token palette (drives the tinted Type pill everywhere)
- **Rename**: the label is display-only; the `key` slug is stable and used by import/export matching
- **Reorder**: controls dropdown and settings ordering
- **Make default**: exactly one default per workspace; pre-selected on new features and used for rows with a NULL `type_id`
- **Roadmap toggle**: `show_on_roadmap`; only flagged types appear on the [Roadmap](https://productos.ca/documentation/pages/overview/roadmap) page and on the public/embed roadmap (default: Feature only), so bugs and internal work stay off both, and never leak to customers. A feature with no type follows the default type's toggle on the Roadmap page; the public roadmap withholds it.
- **Archive**: soft-retire. Archived types stay resolvable on existing features but aren't offered for new ones; they're listed under **Archived** with a **Restore** action. The default type can't be archived; pick a new default first. There is intentionally no delete in the UI.

## Where Type appears

- The **Type column** on /features (first enum column; filterable), the type select in the feature dialog header next to Status, and the table cell editor
- Sprint-board and roadmap **cards**, feature pill **hover tooltips**, and member-pill feature lists
- **Import/export**: the Features sheet's `Type` column (matched case-insensitively by label or key; unknown values fall back to the workspace default)
- **API**: `type_id` is writable/filterable on `/api/v1/features`; the catalog itself is CRUD-able at `/api/v1/work-item-types`
- **AI**: the copilot reads each feature's type and resolves `type_id` against this catalog when proposing changes

## Related

- [Features](https://productos.ca/documentation/pages/golden-thread/features): status workflow + work-item fields (estimate/spent hours, lead)
- [Import / export](https://productos.ca/documentation/pages/settings/import-export): Features sheet columns
- [Custom fields](https://productos.ca/documentation/pages/settings/custom-fields): the other per-workspace taxonomy surface