diff --git a/docs.json b/docs.json
index 0064df7..1380c69 100644
--- a/docs.json
+++ b/docs.json
@@ -73,6 +73,7 @@
             "group": "Workspace",
             "icon": "building-2",
             "pages": [
+              "platform/workspaces-and-members",
               "platform/repositories",
               "platform/connections",
               "platform/contributors",
diff --git a/llms.txt b/llms.txt
index b2909b5..55f78e9 100644
--- a/llms.txt
+++ b/llms.txt
@@ -68,6 +68,7 @@ Use when the user asks about a hosted feature: Ask, graphs, reviews, verificatio
 
 Use for repository indexing and sync, connected agents, contributors and profiles.
 
+- [Workspaces, members and roles](https://docs.graphify.com/platform/workspaces-and-members.md): How Graphify workspaces work: the one you own, ones you join by invite, roles, access requests, and switching between them.
 - [Repository indexing and sync: builds and reindex](https://docs.graphify.com/platform/repositories.md): How Graphify indexes and syncs GitHub and GitLab repositories: build states, reindex rules, the push allowance, and indexing error codes.
 - [Agents and integrations](https://docs.graphify.com/platform/connections.md): Connect Claude Code, Codex, Cursor or another coding agent to your hosted Graphify workspace over MCP, add shared knowledge and manage your integrations.
 - [Contributors: code authorship and reach](https://docs.graphify.com/platform/contributors.md): See who wrote what in a repository: authorship, the reach of each contributor's code in the graph, and any available commit signing evidence.
diff --git a/platform/workspaces-and-members.mdx b/platform/workspaces-and-members.mdx
new file mode 100644
index 0000000..13fe69f
--- /dev/null
+++ b/platform/workspaces-and-members.mdx
@@ -0,0 +1,72 @@
+---
+title: "Workspaces, members and roles"
+sidebarTitle: "Workspaces and members"
+description: "How Graphify workspaces work: the one you own, ones you join by invite, roles, access requests, and switching between them."
+keywords: ["workspace members", "invite teammates", "workspace roles", "request access", "switch workspace"]
+surface: "cloud"
+icon: "users-round"
+---
+
+**One workspace you own. Others you join.** Your account always has a workspace you own. Teammates invite you into theirs, or you request access when they already connected your GitHub organization.
+
+<Columns cols={3}>
+  <Card title="Own one" icon="home">
+    Each person owns one workspace. You join others by invite.
+  </Card>
+  <Card title="Four roles" icon="shield">
+    Owner, Admin, Member, and Billing control who can invite, manage, and open billing.
+  </Card>
+  <Card title="Switch anytime" icon="arrow-left-right">
+    When you belong to more than one workspace, the sidebar switcher lists them all.
+  </Card>
+</Columns>
+
+## Roles
+
+| Role | What they can do |
+| --- | --- |
+| **Owner** | Full control, including inviting people, approving access requests, and opening the billing portal. A workspace always keeps at least one owner. |
+| **Admin** | Invite people, manage members, and approve access requests. Cannot open the billing portal. |
+| **Member** | Use the workspace: repositories, graphs, reviews, Ask, and agents. Cannot invite or manage members. |
+| **Billing** | Open the billing portal and manage payment. Cannot resume a paused Free workspace or manage members. |
+
+Owners and admins manage the member roster. Only owners and billing members can open the Stripe billing portal on **Billing**.
+
+## Invite teammates
+
+Member management is available on **Teams** workspaces. Free and Pro personal workspaces stay single-player until you move to Teams.
+
+<Steps>
+  <Step title="Open Members">
+    In your [Graphify](https://app.graphify.com) workspace, open **Members**.
+  </Step>
+  <Step title="Send an invite">
+    Click **Invite**, enter their email, and choose **Admin** or **Member**. Each person uses one seat.
+  </Step>
+  <Step title="They accept">
+    They get an email (or a one-time accept link you can copy). After they join, you can change their role to Admin, Member, or Billing.
+  </Step>
+</Steps>
+
+## Request access
+
+If a teammate already installed Graphify on your GitHub organization, connecting that org can offer **request access** instead of creating a second workspace. Owners review pending requests on **Members** and in **Settings**.
+
+## Switch workspaces
+
+When you belong to more than one workspace, the sidebar workspace switcher lists every workspace you can open. Pick one to move there. Agents keep their own workspace selection over MCP with `list_workspaces` and `set_workspace`. See [Hosted MCP server](/platform/hosted-mcp).
+
+## Last active on Members
+
+The **Members** roster shows **Last active** for each person. It combines console use and agent calls into one line. Hover for the split between Graphify, agent, and pull request activity.
+
+## Related
+
+<Columns cols={2}>
+  <Card title="Plans and pricing" icon="credit-card" href="/platform/support/pricing">
+    Free, Pro, Teams, trials, and billing.
+  </Card>
+  <Card title="Repositories and builds" icon="folder-git" href="/platform/repositories">
+    Connect repos and watch indexing.
+  </Card>
+</Columns>