> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing

> Compare Zespan pricing plans, understand overage billing, view usage, and manage your subscription.

<Note>
  Billing is visible to **Owner**, **Admin**, and **Billing** roles. Only **Owner** and **Billing** can make changes — upgrade, downgrade, cancel, or update payment details. Admin can view the plan and usage but cannot modify billing. **Editor** and **Viewer** have no billing access at all. See [Organizations](/account/organizations) for the full role breakdown.
</Note>

Zespan bills per organization through [Polar](https://polar.sh). Manage your subscription from **Settings → Billing**.

## Plans

|                    | Free    | Solo    | Pro       | Team      | Scale     |
| ------------------ | ------- | ------- | --------- | --------- | --------- |
| **Price**          | \$0/mo  | \$39/mo | \$149/mo  | \$299/mo  | Custom    |
| **Traces/month**   | 10K     | 100K    | 500K      | 2M        | 10M+      |
| **Data retention** | 14 days | 30 days | 90 days   | 180 days  | 365 days  |
| **Projects**       | 2       | 10      | Unlimited | Unlimited | Unlimited |
| **Members**        | 1       | 1       | Up to 10  | Up to 15  | Unlimited |
| **SSO (OIDC)**     | —       | —       | —         | Included  | Included  |
| **Self-hosted**    | —       | —       | —         | —         | Available |

## Overage billing

When your organization exceeds its monthly trace quota, additional traces are billed at the end of the period:

| Plan  | Overage rate        |
| ----- | ------------------- |
| Solo  | \$0.50 / 10K traces |
| Pro   | \$0.50 / 10K traces |
| Team  | \$0.50 / 10K traces |
| Scale | Custom              |

On the **Free** plan there is no overage — traces are dropped once the monthly limit is reached.

The usage bar in **Settings → Billing** shows your current month-to-date count against your quota and updates in real time.

## Extra seats

Each plan includes a set number of members before you pay per seat: Free and Solo don't allow extra seats at all (you must upgrade to add members), Pro is **$10/seat/month** beyond its included 10, and Team is **$8/seat/month** beyond its included 15. **Settings → Billing** shows a seat-cost preview before you confirm an invite that would push you over your included count.

## What's gated by plan

Beyond trace quota, retention, and seats, several features require a specific plan or higher:

| Feature                              | Minimum plan |
| ------------------------------------ | ------------ |
| ZespanPilot / AI features            | Solo         |
| Alerts                               | Pro          |
| Audit log                            | Pro          |
| Cost attribution / Cost Optimizer    | Pro          |
| Prompt Enhance                       | Pro          |
| Playground BYOK (bring your own key) | Pro          |
| Evaluations (create/manage)          | Team         |
| Simulations                          | Team         |
| Incidents                            | Team         |
| SSO (OIDC)                           | Team         |
| Auto-evaluators                      | Team         |
| Guardrails                           | Scale        |
| Self-hosted deployment               | Scale        |

<Note>
  This table lists plan-level feature gates as implemented in the product. If a page elsewhere in these docs states a different minimum plan for a specific feature, trust that page's own gating note first — some features (like Audit log) are gated by plan rather than by role, so every role can see them once the organization is on a qualifying plan.
</Note>

## Opening billing settings

1. Sign in as an **Owner**, **Admin**, or **Billing**-role member of your organization.
2. Click your organization name in the top navigation.
3. Go to **Settings → Billing**.

You'll see your current plan and month-to-date usage. **Owner** and **Billing** additionally see options to upgrade, downgrade, or manage payment — **Admin** sees this page read-only.

## Upgrading your plan

1. In **Settings → Billing**, click **Upgrade** or **Change plan**.
2. Select the plan you want.
3. If you don't have an active subscription yet, you're redirected to a Polar checkout page — enter or confirm your payment details. Zespan never stores card information. If you already have an active subscription, the change applies in place (no redirect) and is prorated automatically.
4. Once payment is confirmed, your new limits take effect **immediately**, and Zespan emails the organization's owners a confirmation.

Mid-month upgrades are prorated for the remaining days in the billing period.

## Downgrading your plan

1. In **Settings → Billing**, click **Change plan**.
2. Select a lower plan (Solo, Pro, or Team — downgrading to Free is done by [cancelling](#cancelling) instead).
3. Zespan applies the change to your existing subscription via Polar with prorated billing — no separate checkout is needed.
4. The new (lower) limits take effect **immediately**, the same as an upgrade.

## Payment, invoices, and billing details

1. In **Settings → Billing**, click **Manage billing**.
2. You're taken to the Polar customer portal where you can:
   * Update your credit card or payment method
   * Download past invoices as PDFs
   * Update billing address or tax ID

## Cancelling

<Warning>
  Cancellation takes effect at the end of the current billing period. Your organization moves to the Free plan — data retention drops to 14 days and any data older than that becomes inaccessible.
</Warning>

1. In **Settings → Billing**, click **Manage billing**.
2. In the Polar customer portal, cancel your subscription.
3. Your current plan stays active until the end of the billing period.

After downgrade to Free:

* Traces capped at 10K/month
* Data retention drops to 14 days
* Max 2 projects and 1 member