Detailed changes
@@ -1,45 +1,63 @@
---
title: Admin Controls - Zed Business
-description: Configure AI, collaboration, and privacy settings for your entire Zed Business organization.
+description: Configure AI, collaboration, and data sharing settings for your entire Zed Business organization.
---
# Admin Controls
-Owners and admins can configure settings that apply to every member of the
-organization. These controls let you set consistent policies for AI usage,
-collaboration, and data sharing across your team.
+Owners and admins can configure settings that apply to every member of the organization.
+
+These controls cover Zed's server-side features — things that route through Zed's
+infrastructure. They don't cover bring-your-own-key (BYOK) configurations or
+third-party extensions, since Zed is open source and those work independently of
+Zed's servers.
+
+## Accessing Admin Controls
+
+<!-- TODO: document exact location in dashboard before launch -->
+
+Admin controls are available to owners and admins from the organization dashboard at
+[dashboard.zed.dev](https://dashboard.zed.dev).
+
+---
## Collaboration
-You can disable Zed's real-time collaboration features for your organization. When
-disabled, members cannot use channels, shared projects, or live editing.
+You can disable Zed's real-time collaboration features for the entire organization.
+This covers [Channels](../collaboration/channels.md), shared projects, and voice chat —
+the features available in the
+[Collaboration Panel](../collaboration/overview.md).
+
+When collaboration is disabled, members won't see collaboration features in their Zed
+client.
-<!-- TODO: confirm exact collaboration features covered by this toggle before launch -->
+<!-- TODO: confirm exact set of collaboration features covered by this toggle before launch -->
## Hosted AI Models
-You can control which AI models are available to members through Zed's hosted
-service. Options include:
+You can control which of Zed's hosted AI models are available to members. Options are:
-- Disabling all hosted models, so members must bring their own API keys
-- Restricting which models are available from the hosted service
+- Disable all Zed-hosted models entirely, so members must use their own API keys via
+ [Providers](../ai/llm-providers.md) if they want AI features
+- Enable or disable access by model provider (Anthropic, OpenAI, Google, etc.)
-<!-- TODO: confirm granularity of model controls (all-or-nothing vs. per-model) before launch -->
+This control only applies to Zed's hosted model service. Members who bring their own
+API keys are not affected.
+
+<!-- TODO: confirm exact model provider controls available at launch -->
## Edit Predictions
You can disable Zed's Edit Predictions for all members of the organization.
-## Telemetry and Training Data Sharing
-
-You can disable telemetry and training data sharing for all members of the organization.
-See [Privacy for Business](../privacy-for-business.md) for details on what this covers.
+## Data Sharing with Zed
-<!-- TODO: confirm exact scope of this toggle (which telemetry categories, which training data sharing) before launch -->
+You can block members from sharing data with Zed for product improvement purposes.
+This covers:
-## Accessing Admin Controls
+- Edit prediction feedback and training data
+- Agent panel interactions shared with Zed
-<!-- TODO: document exact location in dashboard before launch -->
+This is enforced at the org level — members can't opt back in individually.
-Admin controls are available to owners and admins from the organization dashboard at
-[dashboard.zed.dev](https://dashboard.zed.dev).
+<!-- TODO: confirm exact scope of data sharing controls before launch -->
@@ -6,34 +6,48 @@ description: Create and manage a Zed Business organization, invite members, and
# Organizations
A Zed organization is the container for your team's Zed Business subscription. It
-groups your members under a single account, with centralized billing and shared admin
+groups your members under a single account with centralized billing and shared admin
controls.
+## Personal Organizations
+
+Every Zed account comes with a personal organization created automatically at sign-up.
+This is your individual workspace — your own subscription, billing, and settings, separate
+from any team you belong to.
+
+Your personal organization always stays active. Joining a Zed Business organization
+doesn't replace or affect it. You can switch between organizations from the organization
+menu in the title bar.
+
+## Multiple Organizations
+
+A Zed account can belong to more than one organization at the same time. If you're
+invited to a second organization while already a member of one, you simply join both.
+Each organization has its own subscription, billing, and admin controls.
+
## Creating an Organization
<!-- TODO: document exact creation flow from dashboard before launch -->
-You create an organization from the Zed dashboard at
-[dashboard.zed.dev](https://dashboard.zed.dev). Once created, you become the
-organization owner.
+Organizations are created from the Zed dashboard at
+[dashboard.zed.dev](https://dashboard.zed.dev). The person who creates the organization
+becomes its owner.
## Inviting Members
-Members are invited by email. When an invitation is accepted, the member's Zed account
-is added to the organization and covered by the organization's subscription.
-
-<!-- TODO: confirm exact invite flow (email domain restriction? approval step?) before launch -->
+Members are invited by email address. When an invite is accepted, the member's Zed
+account joins the organization and is covered by its subscription.
To invite a member:
1. Go to the Members page in your organization dashboard.
2. Select **+ Invite Member**.
3. Enter the member's email address and choose a role.
-4. The invitee receives an email with instructions to join.
-
-After accepting, the member authenticates via GitHub and is added to the organization.
+4. They'll receive an email with a link to join.
-For details on what each role can do, see [Roles & Permissions](./roles.md).
+After accepting, they authenticate with their GitHub account and are added to the
+organization. For details on what each role can do, see
+[Roles & Permissions](./roles.md).
## Managing Members
@@ -49,12 +63,13 @@ Owners and admins can manage members from the Members page in the dashboard.
1. On the Members page, find the member.
2. Select **Remove** and confirm.
-Removing a member ends their access to organization-managed features. They can continue
-using Zed individually.
+Removing a member ends their access to the organization's subscription and admin-managed
+settings. Their personal Zed account and any other organization memberships are
+unaffected.
## Organization Dashboard
<!-- TODO: add screenshot of org dashboard before launch -->
-The organization dashboard shows members, roles, and billing. Owners and admins can
-access all settings; members have no access to the dashboard.
+The dashboard shows your members, roles, and billing. Owners and admins have full
+access; members have no dashboard access.
@@ -1,29 +1,37 @@
---
title: Zed Business
-description: Zed Business gives teams centralized billing, admin controls, and enforced privacy settings for every member of your organization.
+description: Zed Business gives teams centralized billing, org-wide admin controls, and enforced privacy settings for every member of your organization.
---
# Zed Business
-Zed Business is a plan for organizations where developers have already chosen Zed but
-need admin controls to get it approved. It adds org-wide data controls, centralized
-billing, and RBAC — the things security teams and engineering leaders need to say yes.
+Zed Business is Zed for your whole team. Every member gets full Zed Pro access, and
+administrators get the controls they need to manage how Zed is used across the
+organization — what AI features are available, what data leaves your environment, and
+how AI spend is tracked.
+
+It's designed for teams that want modern AI tooling without compromising on security or
+privacy, and for companies that need to meet procurement and compliance requirements
+before they can deploy new developer tools.
## What's Included
-Every member of a Zed Business organization gets full Zed Pro features, including all
-hosted AI models and Edit Predictions.
+Every member gets full Zed Pro access: all hosted AI models and Edit Predictions.
+
+For the organization:
-For the organization as a whole:
+- **Org-wide data controls** — administrators decide what data leaves your environment.
+ Zed-hosted AI, Edit Predictions, and real-time collaboration can be toggled on or off
+ for the whole org. Members don't need to configure anything individually.
+- **Private by default, not by configuration** — Zed doesn't store your team's prompts
+ or train on them, and that's not something members can change on their own.
+- **RBAC and permissions** — owners, admins, and members each have clearly defined
+ access. Billing and org settings are only available to the roles that need them.
+- **Unified invoices** — your team's licenses and AI usage go on one Zed account. No
+ separate bills per member.
-- **Org-wide data controls** — administrators can restrict what data leaves the
- organization: Zed-hosted AI models, Edit Predictions, collaboration, and telemetry
- can all be disabled at the org level
-- **Private by default, not by configuration** — Zed does not store your team's prompts
- or train on them; this applies regardless of individual member settings
-- **RBAC & permissions** — role-based access across the organization, with Owner, Admin,
- and Member roles
-- **Centralized billing** — one invoice covering all members' licenses and AI usage
+<!-- TODO: confirm Edit Predictions behavior for Business (unlimited vs. metered) before launch -->
+<!-- TODO: confirm whether per-member usage visibility ships at launch -->
## How It Differs from Pro
@@ -32,11 +40,8 @@ For the organization as a whole:
| Hosted AI models | — | ✓ | ✓ |
| Edit Predictions | — | ✓ | ✓ |
| Org-wide data controls | — | — | ✓ |
-| RBAC & permissions | — | — | ✓ |
-| Centralized billing | — | — | ✓ |
-
-<!-- TODO: confirm Edit Predictions behavior for Business (unlimited vs. metered) before launch -->
-<!-- TODO: confirm whether per-member usage visibility ships at launch -->
+| RBAC and permissions | — | — | ✓ |
+| Unified invoices | — | — | ✓ |
## Getting Started