---
title: "Work items"
description: "What work items are in Spool, how they fit together, and where to find them."
---

> Documentation Index
> Fetch the complete documentation index at: https://spool.team/llms.txt
> Use this file to discover all available pages before exploring further.

# Work items

A work item is one piece of work your team needs to do: a feature, a fix, a chore. Items live in a project, have a key like `ACM-42`, and carry everything about the work in one place: the description, who owns it, its status, and the conversation around it.

## What an item holds

Every item has:

- **A key.** The team key plus a number, such as `ACM-42`. Keys never change, so you can paste them into chat or a commit message and anyone can find the item.
- **A title and a description.** Descriptions are written in a rich editor that saves as Markdown.
- **A type.** Spool starts every workspace with **Epic**, **Story**, **Task** and **Bug**.
- **A status, a priority and an estimate.** These say where the work is, how much it matters, and how big it is.
- **People.** An **Assignee** who does the work and a **Requested by** person who asked for it.
- **Planning fields.** The **Epic** it belongs to and the **Sprint** it is planned into.
- **Activity.** Comments, replies and a history of every change.
- **Links.** Connections to other items, docs, meetings and artifacts.

## Epics and standard items

Types come in two levels. Epic-level types group other items. Standard types (Story, Task and Bug by default) are the work itself. An epic's page lists the items in it under **In this epic**, with a count of how many are done.

There are only two levels. To break a standard item down further, add a checklist to its description. Each checkbox counts towards the item's criteria progress, which shows on the item and in lists.

## Where you find items

- **A project's Items page** shows every item in that project as a list or a board.
- **My items**, in the sidebar, shows items assigned to you or requested by you, across every team you belong to.
- **The item page** opens when you click an item. Its address uses the key, for example `/acme/items/ACM-42`.
- **Sprints** show the items planned into each sprint.

## Who can work with items

Anyone in a team can read its items. What else you can do depends on your team role.

| Role | Read | Comment | Create, edit and delete |
| --- | --- | --- | --- |
| Team lead | Yes | Yes | Yes |
| Team member | Yes | Yes | Yes |
| Team viewer | Yes | Yes | No |

Workspace owners and admins can do everything in every team, even if they aren't members.

## In this section

- **Create and edit items** — Add items, pick a type, use description templates and track criteria.
- **Status, priority and estimates** — Move work through statuses, including Triage, and size it.
- **Views and filters** — List and board, grouping, filters, hidden completed items and My items.
- **Comments, mentions and links** — Talk about the work, mention people, subscribe and connect records.

## Related

- [Key concepts](https://spool.team/docs/get-started/key-concepts/)
- [Sprints](https://spool.team/docs/sprints/overview/)

Source: https://spool.team/docs/work-items/overview/index.mdx
