---
title: "Key concepts"
description: "The building blocks of Spool, from workspaces and teams to items, statuses, links and mentions."
---

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

# Key concepts

A few ideas explain most of how Spool works. Read this once and the rest of the docs will make sense.

## Workspace

A workspace is your company's account, for example "Acme". It holds your members, teams and settings. Spool is invite-only, so you join a workspace by accepting an invite. You can belong to more than one and switch between them from the workspace name at the top of the sidebar.

Everyone in a workspace has a workspace role:

| Role | What it means |
| --- | --- |
| **Owner** | Can do everything, including the owner-only actions. |
| **Admin** | Can do everything except the owner-only actions. Acts in every team. |
| **Member** | Can see the workspace directory and join open teams. |
| **Guest** | Sees only the teams they're added to. |

Workspaces can also add custom roles.

## Team

A team is a group of people inside a workspace. Each team has its own members, projects and statuses. Use one per client, vendor or internal group.

- **Key:** a short code of 2 to 5 letters or digits, starting with a letter, like `ACM`. It prefixes every item key in the team.
- **Visibility:** an **Open** team can be seen and joined by everyone in the workspace. A **Private** team is hidden from everyone except its members and workspace admins.
- **Team roles:** **Lead** has every team permission. **Member** works on items, docs, artifacts, projects and sprints. **Viewer** can comment on items and docs.

Workspace Owners and Admins act in every team with full permissions, even if they aren't members.

## Project

A project is one piece of work inside a team, like a product, a client engagement or a workstream. It's where the work lives: its items, sprints, meetings, docs and artifacts. A project can be archived to keep its history, or deleted for good.

## Item

An item is a unit of work. It belongs to a project and gets a key from its team, like `ACM-42`. Items have a type, status, priority, assignee and, optionally, an epic and an estimate.

Workspaces start with four item types:

| Type | Use it for |
| --- | --- |
| **Epic** | A large body of work that groups stories, tasks and bugs. |
| **Story** | A user-facing change with acceptance criteria. |
| **Task** | A unit of work that is not user-facing. |
| **Bug** | Something that does not work as intended. |

Admins can change these in workspace settings under **Work item types**.

## Statuses

Every status belongs to one of seven categories, in this order: **Triage**, **Backlog**, **Todo**, **In Progress**, **In Review**, **Done** and **Canceled**. A new workspace has one status per category with the same names.

Workspace statuses are copied into every team. Each team can add its own on top, but can't remove the workspace ones.

**Triage** is for new work no person has accepted yet. Items created by agents land there. Items you create yourself start in **Backlog** unless you pick another status.

## Links and origin

Items can link to other records so you can see how work connects. On an item you can add:

- **Related:** two items are connected.
- **Blocks:** this item has to be done first. The other item shows it as **Blocked by**.
- **Duplicate:** this item repeats another one.
- **Origin:** where the item came from. An origin points at a meeting or a doc, and that record shows the item under **Source of**.

## Mentions

Type <kbd>@</kbd> in a description, comment or doc to mention a person, an item, a doc or an artifact. Mentioning a person notifies them. Mentioning a record creates a link, and the other side lists it under **Mentioned in**. You can also type a key like `@ACM-42` and it becomes a link when you save.

## Following

You follow an item when you create it, are assigned to it, are mentioned in it or comment on it. You can also click **Subscribe** on any item. Updates on items you follow appear in the **Following** tab of your [Inbox](https://spool.team/docs/inbox/overview/).

## Related

- [Quickstart](https://spool.team/docs/get-started/quickstart/)
- [Finding your way](https://spool.team/docs/get-started/finding-your-way/)
- [Glossary](https://spool.team/docs/reference/glossary/)

Source: https://spool.team/docs/get-started/key-concepts/index.mdx
