Skip to content

Key concepts

The building blocks of Spool, from workspaces and teams to items, statuses, links and mentions.

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.

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 @ 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.

Type to search…

↑↓ navigate↵ selectEsc close