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

# Statuses

> Track where each session sits in your workflow with a single status drawn from open and closed states.

A status records where a session sits in your workflow. Every session has exactly one status at a time — that's the key difference from [labels](/labels/overview), which are additive. As a session moves from an idea to finished work, its status moves with it, and Synti uses that status to decide whether the session shows up in your active lists or your archive.

## Open and closed

Every status belongs to one of two categories:

* **Open** — active sessions that appear in your Inbox and active lists.
* **Closed** — finished or abandoned sessions that move to the Archive.

Moving a session to a closed status archives it; moving it back to an open status returns it to the inbox. The session's content and history are untouched either way — only its placement changes.

## Built-in statuses

Synti ships with five statuses out of the box:

| Status       | Category | Meaning                                         |
| ------------ | -------- | ----------------------------------------------- |
| Backlog      | Open     | Ideas and work to pick up later                 |
| Todo         | Open     | Ready to work on — the default for new sessions |
| Needs Review | Open     | Waiting on review or feedback                   |
| Done         | Closed   | Completed successfully                          |
| Cancelled    | Closed   | No longer needed                                |

New sessions start as **Todo**.

## What you can change

Each status carries a protection level that controls how far you can edit it:

* **Fixed** (`isFixed: true`) — can't be deleted or renamed, because Synti relies on it. `todo`, `done`, and `cancelled` are fixed. You can still change their [color](/customisation/colors) and [icon](/customisation/icons).
* **Default** (`isDefault: true`) — ships with the app and can't be deleted, but you can freely change its color, icon, and label. `backlog` and `needs-review` are defaults.
* **Custom** — anything you create yourself, fully editable and deletable.

This is why `todo`, `done`, and `cancelled` always exist: they anchor the "start," "finished," and "abandoned" ends of every workflow.

## Appearance

Unlike labels, statuses pair a **color and an icon**. Colors come from the same [system tokens or custom values](/customisation/colors) used everywhere in Synti, and icons can be an emoji or a theme-aware SVG — see [Icons](/customisation/icons). By default, `backlog`, `todo`, and `cancelled` are muted, `in-progress` is `success`, `needs-review` is `info`, and `done` is `accent`.

## Changing a session's status

Set a session's status from its menu or with a keyboard shortcut. Because status drives archival, this doubles as your archive/unarchive action — closing a session tucks it away, reopening brings it back.

## Configuration

Each workspace keeps its own status configuration:

```text theme={null}
~/.synti/workspaces/{workspace-id}/statuses/config.json
```

Icons for statuses live alongside it in a dedicated `icons/` subdirectory. To add your own statuses, reorder them, or restyle the built-ins, see [Customizing statuses](/statuses/customizing).

<CardGroup cols={2}>
  <Card title="Customizing statuses" icon="sliders" href="/statuses/customizing">
    Add, edit, reorder, and restyle statuses.
  </Card>

  <Card title="Labels" icon="tags" href="/labels/overview">
    Additive tags that complement the single-status workflow.
  </Card>
</CardGroup>
