diff --git a/content/docs/grid/fractal/index.mdx b/content/docs/grid/fractal/index.mdx
index 5a628ea..d08a11e 100644
--- a/content/docs/grid/fractal/index.mdx
+++ b/content/docs/grid/fractal/index.mdx
@@ -67,6 +67,8 @@ managed database, autoscaling, and push-to-deploy built in. Work visually in the
   and wake instantly on the next request
 - **Preview environments and canaries**: an ephemeral environment for every pull
   request, plus weighted canary rollouts for safe releases
+- **Container shell**: open an interactive terminal in a running container from
+  the dashboard to inspect a live service, role-gated and audited
 
 ## Get started
 
diff --git a/content/docs/grid/fractal/meta.json b/content/docs/grid/fractal/meta.json
index 167311d..34a1062 100644
--- a/content/docs/grid/fractal/meta.json
+++ b/content/docs/grid/fractal/meta.json
@@ -8,6 +8,7 @@
     "pr-previews",
     "custom-domains",
     "backups",
+    "shell",
     "cli-reference",
     "architecture",
     "---Reference---",
diff --git a/content/docs/grid/fractal/shell.mdx b/content/docs/grid/fractal/shell.mdx
new file mode 100644
index 0000000..213d5cc
--- /dev/null
+++ b/content/docs/grid/fractal/shell.mdx
@@ -0,0 +1,37 @@
+---
+title: Shell
+description: Open an interactive terminal in a running container
+---
+
+Fractal can drop you into an **interactive shell inside a running container**,
+straight from the dashboard, so you can inspect a live service without wiring up
+your own access.
+
+## Open a shell
+
+From a service's detail page, select the **Shell** tab. Fractal connects a
+terminal to a running instance of the service and starts a shell
+(`/bin/bash` when the image has it, otherwise `/bin/sh`).
+
+The Shell tab is available for **web and worker** services (the long-running
+workloads that have a container to attach to). Managed databases, static sites,
+and cron jobs do not show it.
+
+If the service is **asleep** (scaled to zero) there is no container to connect
+to. Wake it first, by sending it a request or scaling it up, and reopen the tab.
+
+## Who can use it
+
+Opening a shell requires **deploy-level access** to the project (owner, admin,
+or developer). Project viewers cannot open a shell. Every session is recorded in
+the project's audit trail (who connected, to which service, and when).
+
+## Good to know
+
+- **Sessions are temporary.** The connection is not recorded, and anything you
+  change on the container's filesystem is lost on the next deploy. Make lasting
+  changes through your repository or configuration, not the shell.
+- **Idle sessions close automatically** after a period of inactivity, and each
+  connection is scoped to a single running instance.
+- The terminal needs a **WebGPU-capable browser**. On an unsupported browser the
+  tab shows a note instead of a terminal.