## Summary - Adds 63 internal links across 41 documentation pages. - Connects existing terms such as Agent Panel, semantic tokens, edit predictions, and language-specific debugging to their detailed reference pages. - Uses existing wording for 60 links and makes three small wording changes where a natural anchor did not already exist. ## Why this matters Readers can now move from overview and configuration pages to the relevant detailed guidance without searching the documentation manually. The changes add navigation only. They do not change product behavior or documented requirements. ## Jev experiment This PR came from a local experiment using Jev to audit internal links across the published documentation. The audit scripts are not included in this PR. - Code shortlisted 2,715 possible source and destination page pairs. - Jev made two separate decisions for each pair: whether the link would help the reader, and which exact existing phrase should become the anchor. - Five strong links without existing anchor text went to GPT-5.6 Luna for minimal rewrite options. Jev then selected among those fixed options. - A local review interface surfaced the results for Pass or Fail decisions before any files changed. Human review approved 66 changes. Two no longer matched the current `main` branch, and review removed one circular link, leaving the 63 links in this PR. ## Validation - `pnpm dlx prettier@3.5.0 <changed docs> --check` - `lychee --exclude '^http' './docs/src/**/*'` — 0 errors - `mdbook build docs` - Verified that the diff adds exactly 63 Markdown links Release Notes: - Improved links between related documentation pages.
4.0 KiB
title, description
| title | description |
|---|---|
| Roles - Zed | Understand Zed's organization roles and what each role can access, manage, and configure. |
Roles
Every member of a Zed organization is assigned a role that determines what they can access and configure.
Role Types
Every member of an organization is assigned one of four roles:
| Capability | Owner | Admin | Billing Manager | Member |
|---|---|---|---|---|
| Use hosted AI and Edit Predictions through Business | Yes | Yes | No | Yes |
| View organization members | Yes | Yes | Yes | Yes |
| Invite members | Yes | Yes | No | No |
| Change non-owner member roles | Yes | Yes | No | No |
| Remove non-owner members | Yes | Yes | No | No |
| Configure organization settings and data controls | Yes | Yes | No | No |
| View subscription, usage, and billing information | Yes | Yes | Yes | No |
| Update billing details, tax ID information, and payment methods | Yes | Yes | Yes | No |
| Cancel the subscription | Yes | No | No | No |
| Transfer ownership | Yes | No | No | No |
Owner
An owner has full control over the organization, including:
- Invite and remove members
- Assign and change member roles
- Manage billing, payment methods, and invoices
- Configure data-sharing policies
- Disable Zed's collaborative features
- Control whether members can use Zed-hosted models and Zed's edit predictions
- Transfer ownership to another member
Admin
Admins can manage members, roles, organization settings, data controls, and billing. They have the same capabilities as the Owner, except they cannot:
- Cancel the subscription
- Transfer organization ownership
This role is suited for team leads or managers who handle day-to-day member access and organization settings.
Billing Manager
Billing Managers can view subscription usage, update billing details and tax ID information, update payment methods, and access invoice history.
This role does not count toward paid Business seats. It also does not include Zed-hosted AI models or Edit Predictions through the Business subscription. Billing Managers cannot invite or remove members, change member roles, configure organization settings or data controls, cancel the subscription, or transfer ownership.
Member
Members have standard access to Zed through the Business subscription. They cannot access billing or organization settings.
Managing User Roles
Owners and Admins can manage organization members from the Zed dashboard within the Members page.
Inviting Members
- On the Members page, select + Invite Member.
- Enter the member's company email address and choose a role.
- The invitee receives an email with instructions to join. After accepting, they authenticate via GitHub.
Changing a Member's Role
- On the Members page, find the member. You can filter by role or search by name.
- Open the three-dot menu and select a new role.
Removing a Member
- On the Members page, find the member.
- Select Remove and confirm.
Removing a member removes their access to organization settings and any organization-managed features. They can continue using Zed on their own.