Use Cases

Customizing Item Types

Add a custom item type — for example a Spike or a Risk — so teams can plan it on boards and report on it separately.

Setting

A team wants to track Spikes (time-boxed research) distinctly from stories so they show up with their own badge on boards and can be filtered and reported on. Item types are organization-wide and need the settings capability (default Admin).

Steps

  1. Open Configure Settings → Item Types.
  2. Click New Item Type.
  3. Label — enter Spike (at least three characters).
  4. Parent Item Types — choose the type(s) a Spike can sit under, e.g. Epic and Feature. The first you pick is the primary parent; click Make primary on another to change it. Leave it as None (top level) for a root type.
  5. Badge Color — pick a colour that stands out from Story and Bug.
  6. Click Create.

Result

  • Spike appears in the Item Type picker when creating items under the chosen parents, and as a badge on cards and table rows.
  • Boards can filter on it (Filters → Item Type) and the 2D view can use Item Type as a read-only axis.
  • A status can be restricted to certain item types in Item Statuses; a card of a disallowed type cannot be dropped into that column.

Tips

  • Keep the hierarchy shallow; every level is one more thing to pick when creating an item.
  • Points and time estimation are configured per item type, so decide whether Spikes are estimated.
  • Full reference, including multi-parent types: Item Types and Choosing parent item types.