Files
zed/docs/src/roles.md
T
morgankrey 526c95d474 Improve internal links across documentation (#64481)
## 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.
2026-09-19 19:58:09 +00:00

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

  1. On the Members page, select + Invite Member.
  2. Enter the member's company email address and choose a role.
  3. The invitee receives an email with instructions to join. After accepting, they authenticate via GitHub.

Changing a Member's Role

  1. On the Members page, find the member. You can filter by role or search by name.
  2. Open the three-dot menu and select a new role.

Removing a Member

  1. On the Members page, find the member.
  2. 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.