morgankrey created
- Add Plans & Pricing update with Free, Pro, and Business tier descriptions
and comparison table
- Rename Individual Billing page, fix stale subscription.md link, add
cross-reference to org billing
- Add Organization Billing page covering consolidated invoicing, AI spend
limits, and per-member usage visibility
- Update SUMMARY.md with Individual Billing and Organization Billing entries
- Deep cross-linking pass across all business docs (Edit Predictions,
hosted models, ai-improvement, collaboration)
- Reframe data controls as enforced settings; rewrite privacy bullet to
explain opt-in sharing and org-level enforcement
- Fix broken roles.md link in organizations.md
- Full humanizer pass: remove em dashes, inline bold-dash headers, filler
phrases, and copula avoidance across all business docs
Release Notes:
- N/Adocs/src/SUMMARY.md | 3 +
docs/src/ai/billing.md | 9 ++--
docs/src/ai/plans-and-usage.md | 52 ++++++++++++++++++++--------
docs/src/business/admin-controls.md | 39 +++++++--------------
docs/src/business/business-support.md | 7 +--
docs/src/business/org-billing.md | 42 +++++++++++++++++++++++
docs/src/business/organizations.md | 38 +++++++-------------
docs/src/business/overview.md | 30 +++++-----------
8 files changed, 123 insertions(+), 97 deletions(-)
@@ -59,7 +59,8 @@
- [Authenticate](./authentication.md)
- [Plans & Pricing](./ai/plans-and-usage.md)
-- [Billing](./ai/billing.md)
+- [Individual Billing](./ai/billing.md)
+- [Organization Billing](./business/org-billing.md)
# Zed Business
@@ -1,14 +1,13 @@
---
-title: Billing - Zed AI
-description: Manage Zed AI billing, payment methods, invoices, threshold billing, and sales tax information.
+title: Individual Billing
+description: Manage billing for your Zed Pro subscription, including payment methods, invoices, threshold billing, and sales tax information.
---
-# Billing
+# Individual Billing
-This page covers billing for Zed's [subscription plans](./subscription.md). For details on what's included in each plan and how token usage works, see [Plans and Usage](./plans-and-usage.md).
+This page covers billing for individual [Zed Pro](./plans-and-usage.md#pro) subscriptions. For details on what's included in each plan and how token usage works, see [Plans & Pricing](./plans-and-usage.md). For organization billing, see [Organization Billing](../business/org-billing.md).
We use Stripe as our payments provider, and Orb for invoicing and metering. All Pro plans require payment via credit card or other supported payment method.
-For invoice-based billing, a Business plan is required. Contact [sales@zed.dev](mailto:sales@zed.dev) for more information.
## Billing Information {#settings}
@@ -1,25 +1,51 @@
---
-title: Plans and Usage - Zed AI
-description: Understand Zed's AI plans, token-based usage metering, spend limits, and trial details.
+title: Plans & Pricing
+description: Compare Zed's Free, Pro, and Business plans, and understand token-based usage metering, spend limits, and trial details.
---
-# Plans and Usage
-
-## Available Plans {#plans}
+# Plans & Pricing
For costs and more information on pricing, visit [Zed's pricing page](https://zed.dev/pricing).
Zed works without AI features or a subscription. No [authentication](../authentication.md) is required for the editor itself.
-## Usage {#usage}
+## Plans {#plans}
+
+| | Free | Pro | Business |
+| ----------------------- | ---- | --- | -------- |
+| Hosted AI models | — | ✓ | ✓ |
+| Edit Predictions | — | ✓ | ✓ |
+| Enforced data controls | — | — | ✓ |
+| RBAC and permissions | — | — | ✓ |
+| Consolidated billing | — | — | ✓ |
+
+## Zed Free {#free}
+
+The editor is free with no time limit. AI features (hosted models and Edit Predictions) are not included in the Free plan.
+
+## Zed Pro {#pro}
+
+Zed Pro includes access to all hosted AI models and Edit Predictions. The plan includes $5 of monthly token credit. A trial of Zed Pro includes $20 of credit, usable for 14 days.
+
+For details on billing and payment, see [Individual Billing](./billing.md).
-Usage of Zed's hosted models is measured on a token basis, converted to dollars at the rates lists on [the Models page](./models.md) (list price from the provider, +10%).
+## Zed Business {#business}
-Zed Pro comes with $5 of monthly dollar credit. A trial of Zed Pro includes $20 of credit, usable for 14 days. Monthly included credit resets on your monthly billing date.
+<!-- TODO: confirm per-seat pricing before launch -->
-The [Zed Student plan](https://zed.dev/education) includes $10/month in token credits. The Student plan is available free for one year to verified university students.
+Zed Business gives every member full Zed Pro access, plus org-wide controls for administrators: which AI features are available, what data leaves your organization, and how AI spend is tracked. All seats and AI usage are consolidated into a single invoice.
-To view your current usage, you can visit your account at [dashboard.zed.dev/account](https://dashboard.zed.dev/account). Information from our metering and billing provider, Orb, is embedded on that page.
+For a full feature overview, see [Zed Business](../business/overview.md). For billing details, see [Organization Billing](../business/org-billing.md).
+
+## Student Plan {#student}
+
+The [Zed Student plan](https://zed.dev/education) includes $10/month in token credits, available free for one year to verified university students.
+
+## Usage {#usage}
+
+Usage of Zed's hosted models is measured on a token basis, converted to dollars at the rates listed on [the Models page](./models.md) (list price from the provider, +10%).
+
+Monthly included credit resets on your monthly billing date. To view your current usage, visit your account at [dashboard.zed.dev/account](https://dashboard.zed.dev/account). Usage data from our metering provider, Orb, is embedded on that page.
## Spend Limits {#usage-spend-limits}
@@ -31,10 +57,6 @@ Once the spend limit is hit, we'll stop any further usage until your token spend
> **Note:** Spend limits are a Zed Pro feature. Student plan users do not currently have the ability to configure spend limits; usage is capped at the $10/month included credit.
-## Business Usage {#business-usage}
-
-Email [sales@zed.dev](mailto:sales@zed.dev) with any questions on business plans.
-
## Trials {#trials}
-Note that trials will automatically convert to Zed Free plans on termination, and no cancellation is needed to prevent conversion to Zed Pro.
+Trials automatically convert to Zed Free when they end. No cancellation is needed to prevent conversion to Zed Pro.
@@ -7,57 +7,44 @@ description: Configure AI, collaboration, and data sharing settings for your ent
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.
+These controls apply to Zed's server-side features, meaning anything that routes through Zed's infrastructure. They don't cover bring-your-own-key (BYOK) configurations or third-party extensions, since 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).
+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 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.
+Administrators can disable Zed's real-time collaboration features for the entire organization. This covers the features in the [Collaboration Panel](../collaboration/overview.md): [Channels](../collaboration/channels.md), shared projects, and voice chat.
<!-- TODO: confirm exact set of collaboration features covered by this toggle before launch -->
+<!-- TODO: confirm behavior for members on older Zed clients when collaboration is disabled -->
+
+When collaboration is disabled, members won't see collaboration features in their Zed client.
## Hosted AI Models
-You can control which of Zed's hosted AI models are available to members. Options are:
+Administrators can control which of Zed's [hosted AI models](../ai/models.md) are available to members:
-- 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
+- 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.)
-This control only applies to Zed's hosted model service. Members who bring their own
-API keys are not affected.
+This applies to Zed's hosted model service only. 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.
-
-## Data Sharing with Zed
+Administrators can disable [Edit Predictions](../ai/edit-prediction.md) for all members of the organization.
-You can block members from sharing data with Zed for product improvement purposes.
-This covers:
+## Data Sharing
-- Edit prediction feedback and training data
-- Agent panel interactions shared with Zed
+By default, [data sharing with Zed for AI improvement](../ai/ai-improvement.md) is opt-in. Members choose individually whether to share [edit prediction training data](../ai/ai-improvement.md#edit-predictions) or [AI feedback via ratings](../ai/ai-improvement.md#ai-feedback-with-ratings).
-This is enforced at the org level — members can't opt back in individually.
+Administrators can enforce a no-sharing policy org-wide, blocking members from opting into either form of data sharing. This is enforced server-side, so members can't opt back in individually.
<!-- TODO: confirm exact scope of data sharing controls before launch -->
@@ -5,14 +5,11 @@ description: How to contact Zed for business inquiries and support.
# Business Support
-For business inquiries — account setup, billing, organization questions, or anything
-specific to your organization — email [sales@zed.dev](mailto:sales@zed.dev).
+For business inquiries (account setup, billing, organization questions, or anything specific to your organization), email [sales@zed.dev](mailto:sales@zed.dev).
<!-- TODO: confirm support contact before launch (sales@? dedicated business-support@?) -->
<!-- TODO: confirm what dedicated support offering, if any, is available at launch -->
## Open-Source Issues
-Questions and bugs related to the Zed editor itself — features, extensions, language
-support, crashes — are handled through the main Zed project on
-[GitHub](https://github.com/zed-industries/zed/issues).
+Questions and bugs about the Zed editor itself (features, extensions, language support, crashes) go through the main Zed project on [GitHub](https://github.com/zed-industries/zed/issues).
@@ -0,0 +1,42 @@
+---
+title: Organization Billing - Zed Business
+description: How billing works for Zed Business organizations, including consolidated invoicing, AI spend limits, and per-member usage visibility.
+---
+
+# Organization Billing
+
+<!-- TODO: verify org billing behavior with Cloud team before launch -->
+
+Zed Business consolidates your team's costs. Seat licenses and AI usage for all members appear on one bill, with no separate invoices per member.
+
+## Billing Dashboard {#dashboard}
+
+Owners and admins can access billing information at [dashboard.zed.dev](https://dashboard.zed.dev). The dashboard shows:
+
+- Current member count and seat charges
+- AI usage and spend across the organization
+- Per-member usage and spending visibility
+
+## AI Usage {#ai-usage}
+
+AI usage across the organization is metered on a token basis at the same rates as individual Pro subscriptions. See [Plans & Pricing](../ai/plans-and-usage.md#usage) for rate details.
+
+Administrators can set an org-wide AI spend limit from [Admin Controls](./admin-controls.md). Once the limit is reached, AI usage is paused until the next billing period.
+
+## Payment and Invoices {#invoices}
+
+Organization billing uses Stripe for payments, via credit card or other supported payment method.
+
+<!-- TODO: confirm whether invoice-based billing is available at launch -->
+
+Invoice history is accessible from the billing dashboard. For help updating payment methods, names, addresses, or tax IDs, email [billing-support@zed.dev](mailto:billing-support@zed.dev).
+
+> Self-service billing updates will be available in a future release.
+
+Changes to billing information affect future invoices only. Historical invoices can't be modified.
+
+## Sales Tax {#sales-tax}
+
+Zed partners with [Sphere](https://www.getsphere.com/) to calculate indirect tax rates based on your billing address. Tax appears as a separate line item on invoices. If you have a VAT/GST ID, add it during checkout.
+
+Questions about tax can go to [billing-support@zed.dev](mailto:billing-support@zed.dev).
@@ -5,38 +5,31 @@ 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
-controls.
+A Zed organization is your team's Zed Business subscription, with members, billing, and admin controls in one place.
## 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.
+Every Zed account gets a personal organization at sign-up. It has its 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.
+Your personal organization always stays active. Joining a Zed Business organization doesn't replace or affect it.
+
+In the Zed editor, an organization menu in the title bar shows your current organization by name. Click it to see all your organizations and switch between them.
+
+<!-- TODO: confirm how organization switching works in dashboard.zed.dev before launch -->
## 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.
+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 -->
-Organizations are created from the Zed dashboard at
-[dashboard.zed.dev](https://dashboard.zed.dev). The person who creates the organization
-becomes its 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 address. When an invite is accepted, the member's Zed
-account joins the organization and is covered by its subscription.
+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:
@@ -45,9 +38,7 @@ To invite a member:
3. Enter the member's email address and choose a role.
4. They'll receive an email with a link to join.
-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).
+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
@@ -63,13 +54,10 @@ 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 the organization's subscription and admin-managed
-settings. Their personal Zed account and any other organization memberships are
-unaffected.
+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 dashboard shows your members, roles, and billing. Owners and admins have full
-access; members have no dashboard access.
+The dashboard shows your members, roles, and billing. Owners and admins have full access; members have no dashboard access.
@@ -1,34 +1,24 @@
---
title: Zed Business
-description: Zed Business gives teams centralized billing, org-wide admin controls, and enforced privacy settings for every member of your organization.
+description: Zed Business gives every team member full Zed Pro access, with org-wide admin controls and enforced data settings for the whole organization.
---
# Zed Business
-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.
+Zed Business is Zed for your whole team. Every member gets full Zed Pro access, and administrators get controls to manage how Zed is used across the organization: which 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.
+It's for teams that want modern AI tooling without security trade-offs, and for companies with procurement or compliance requirements that have blocked Zed deployment.
## What's Included
-Every member gets full Zed Pro access: all hosted AI models and Edit Predictions.
+Every member gets full Zed Pro access: all [hosted AI models](../ai/models.md) and [Edit Predictions](../ai/edit-prediction.md).
For the organization:
-- **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.
+- **Enforced data controls:** Administrators decide which AI features are available. [Zed-hosted models](../ai/models.md), [Edit Predictions](../ai/edit-prediction.md), and [real-time collaboration](../collaboration/overview.md) can be toggled on or off for the whole org. Members can't override these settings individually.
+- **Private by default:** Zed doesn't store your prompts or train on them. [Data sharing for AI improvement](../ai/ai-improvement.md) is opt-in: members can choose to share but are never enrolled automatically. Administrators can enforce this org-wide, blocking members from opting in at all.
+- **RBAC and permissions:** Owners, admins, and members have different access levels. Billing and org settings are only visible to the roles that need them.
+- **Consolidated billing:** Your team's licenses and AI usage appear on one invoice, with no separate bills per member.
<!-- TODO: confirm Edit Predictions behavior for Business (unlimited vs. metered) before launch -->
<!-- TODO: confirm whether per-member usage visibility ships at launch -->
@@ -39,9 +29,9 @@ For the organization:
| ---------------------- | ---- | --- | -------- |
| Hosted AI models | — | ✓ | ✓ |
| Edit Predictions | — | ✓ | ✓ |
-| Org-wide data controls | — | — | ✓ |
+| Enforced data controls | — | — | ✓ |
| RBAC and permissions | — | — | ✓ |
-| Unified invoices | — | — | ✓ |
+| Consolidated billing | — | — | ✓ |
## Getting Started