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

# Workstreams

> Create and maintain the strategic workstreams used as roadmap swim lanes.

Use **Planning → Workstreams** (`/planning/workstreams`) for the strategic initiatives that appear as swim lanes on roadmap Gantt views. A workstream groups milestones; a [project](https://docs.gloo.com/forge/console/planning/projects.md) organizes a specific body of delivery work.

![Workstreams (light)](https://mintcdn.com/gloo-b243725a/xyq5perq6SLByPBn/forge/images/console/planning/workstreams-light.png?fit=max\&auto=format\&n=xyq5perq6SLByPBn\&q=85\&s=82a4b7fde71be4c6d259b75752d80d89)

Workstreams — Forge Console at `/planning/workstreams`

## What you can do

* Create a workstream for a strategic initiative. See [Create a workstream](#create-a-workstream).
* Archive a workstream that is no longer active, and restore it later. See [Archive and restore](#archive-and-restore).

## Create a workstream

1. Choose **New workstream**.
2. Enter a distinct name and an optional description that explains its scope.
3. Choose **Create**. A blank or whitespace-only name keeps creation disabled.
4. Confirm the new row appears with **Active** status before using it for roadmap milestones.

Choose **Cancel** to close the creation form without submitting. If the save fails, the error banner reports the refusal; correct the cause before retrying.

## Archive and restore

Choose **Archive** on an active row when the initiative should no longer be active. Confirm that it moves into the **Archived** group. Use **Restore** there to return it to active use.

Archiving is a lifecycle change to the workstream. It does not mean every related milestone or project has been completed; inspect the roadmap and delivery work separately.

## Key state to watch

* **Active** or **Archived** — confirm a new workstream shows **Active** before using it for roadmap milestones.
* **Archiving is not completion** — check the roadmap and delivery work separately.

## Troubleshoot

| Symptom | Check |
| - | - |
| **No workstreams yet** | Create the first initiative before organizing roadmap swim lanes. |
| A known workstream is missing | Look in **Archived** and confirm it is in the returned, readable set. |
| Create, Archive, or Restore is refused | Read the error before dismissing it; correct the access or current-state issue, then retry. |
| A roadmap does not show the intended grouping | Check its milestone assignments rather than creating a duplicate workstream. |

See [Roadmaps](https://docs.gloo.com/forge/console/planning/roadmaps.md) and [Critical Path](https://docs.gloo.com/forge/console/planning/critical-path.md).

## Related surfaces

* [Projects](https://docs.gloo.com/forge/console/planning/projects.md): a specific body of delivery work.
* [Roadmaps](https://docs.gloo.com/forge/console/planning/roadmaps.md): the Gantt views that show workstreams as swim lanes.
* [Critical Path](https://docs.gloo.com/forge/console/planning/critical-path.md): milestone tasks in a roadmap, least time remaining first.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.