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

# Change your plan

> Upgrade or downgrade between Starter, Pro, and Enterprise

Change your [Braintrust plan](https://docs.braintrust.dev/plans-and-limits.md) to match your team's needs. You can upgrade from Starter to Pro directly in the application, or contact Braintrust for Enterprise plans. Downgrading is also supported with considerations for feature access and data retention.

## Enable on-demand usage

On-demand usage lets you grow beyond [Starter plan limits](https://docs.braintrust.dev/plans-and-limits.md#usage-limits) without upgrading to Pro. Add a credit card, and you'll automatically be charged for additional usage at the end of each calendar month, with billing on the 1st of the following month.

> [!TIP]
>
> On-demand usage rates on Starter are higher than Pro rates. If your usage consistently grows beyond the Starter plan limits, [upgrading to Pro](https://docs.braintrust.dev/admin/billing/change-plan.md#upgrade-your-plan) provides better economics with lower rates and a higher included usage allowance.

To add a credit card:

1. Go to ** Settings** > [** Billing**](https://www.braintrust.dev/app/~/configuration/billing).
2. Under **On-demand usage**, click **Add card**.
3. Enter your credit card information.
4. Click **Save**.

> [!NOTE]
>
> When you add a card, Braintrust charges a \$1 card validation fee to verify your payment method. The receipt is available in the **Invoices** dropdown on the \*\* Settings\*\* > [\*\* Billing\*\*](https://www.braintrust.dev/app/~/configuration/billing) page.

After on-demand usage is enabled, use **Edit billing information** under **On-demand usage** to update your card, billing address, billing email, purchase order number, or tax information.

## Disable on-demand usage

To stop future charges for usage above Starter plan limits, disable on-demand billing from the **Edit billing information** dialog. Your card stays on file.

> [!WARNING]
>
> This change takes effect immediately. Starter plan limits are enforced from the moment you confirm, and usage above those limits will be blocked.

1. Go to ** Settings** > [** Billing**](https://www.braintrust.dev/app/~/configuration/billing).
2. Under **On-demand usage**, click **Edit billing information**.
3. Under **On-demand billing**, click **Disable**.
4. Click **Disable on-demand billing** to confirm.

The change takes effect immediately and Starter plan limits apply from that point forward.

## Upgrade your plan

> [tab] Starter -> Pro
>
> Upgrade from Starter to Pro to access advanced features, higher usage limits, and lower pay-as-you-go rates.
>
> 1. Go to \*\* Settings\*\* > [\*\* Billing\*\*](https://www.braintrust.dev/app/~/configuration/billing).
> 2. Under **Current plan**, click **Adjust plan**.
> 3. In the plan selection dialog, click **Upgrade to Pro**.
> 4. Review the Pro plan features and pricing.
> 5. Enter your payment information.
> 6. Click **Subscribe**.
>
> You'll be charged a prorated amount for the remainder of the current month. For billing addresses in taxable US jurisdictions, the upgrade preview shows an **Estimated tax** line that updates as you enter your billing address, and the tax is collected together with the prorated charge. On the 1st of the following month, you'll be charged the full \$249 monthly platform fee plus any usage-based charges from the previous month.
>
> > [accordion] Prorated charge example
> >
> > If you upgrade on the 15th of a 30-day month:
> >
> > * Days remaining: 15 (from the 15th to the end of the month)
> > * Prorated charge: \$249 × (15/30) = \$124.50 (using the example \$249 monthly platform fee)
> > * For billing addresses in taxable US jurisdictions, the estimated tax is added on top of the prorated charge.
>
> When you upgrade to Pro, you immediately gain access to:
>
> * Custom dashboards (Build your own dashboards and custom charts to track metrics specific to your use case. The built-in Cost and quality dashboard is available on all plans.)
>
> * Environments (Separate development, staging, and production data within your projects.)
>
> * Unlimited human review scorers (Configure custom scoring workflows where human reviewers can provide feedback on traces.) (Starter limited to 1 per project)
>
> * Built-in permission groups (Built-in permission groups define what users can do in your organization. On Starter, you can assign accounts only to Owners. Pro adds Engineers, Viewers, and All AI Provider Access. Enterprise also supports custom permission groups.) (Starter allows new assignments only to Owners; Enterprise adds custom permission groups)
>
> * [Higher usage limits](https://docs.braintrust.dev/plans-and-limits.md#usage-limits) and lower on-demand rates for processed data and scores
>
> * A larger [monthly Topics credit](https://docs.braintrust.dev/plans-and-limits.md#model-credits), with the same overage rates as Starter
>
> * Longer data retention (30-day retention vs. 14-day retention), [extendable up to 180-day retention](https://docs.braintrust.dev/admin/data-management/retention.md#extend-the-retention-window) for a storage charge
>
> * Priority email support
>
> > [!NOTE]
> >
> > **Alternative**: If you only need higher usage limits, consider [enabling on-demand usage](#enable-on-demand-usage) instead. On-demand usage lets you grow beyond Starter limits without the monthly Pro platform fee, though [on-demand rates](https://docs.braintrust.dev/plans-and-limits.md#usage-limits) are higher than Pro rates.

> [tab] Starter/Pro -> Enterprise
>
> Enterprise plans include custom usage limits, advanced security and compliance features, and dedicated support for large organizations.
>
> To upgrade to Enterprise:
>
> 1. [Contact Braintrust](https://www.braintrust.dev/contact) to discuss your requirements.
> 2. Work with the Braintrust team to configure a custom plan.
> 3. Sign an Enterprise agreement.
>
> Enterprise plans include everything in Pro plus:
>
> * Custom usage limits for processed data and scores
> * Custom data retention policies (Set how long logs, experiments, and datasets are kept, for specific projects or across your organization.)
> * Custom permission groups (Create custom permission groups with fine-grained access control to resources.) (Pro limited to Owner/Engineer/Viewer)
> * SAML/OIDC SSO providers (Single sign-on for centralized identity management.) (Pro and Starter limited to Google only)
> * Domain mappings (Automatically add users from specific email domains to your organization.)
> * Audit logging (Track and review administrative actions in your organization, such as permission changes, member management, and API key creation.)
> * Flexible [deployment options](https://docs.braintrust.dev/admin/deployment.md), including BYOC and self-hosted
> * Compliance and security:
>   * SOC2 attestation (Independent audit confirming that Braintrust's security controls are operating effectively over time.)
>   * Custom DPA (Data Processing Agreement for GDPR compliance requirements to satisfy data processing obligations.) (Pro has click-through DPA)
>   * BAA (Business Associate Agreement for HIPAA compliance to support handling of protected health information (PHI).)
> * Dedicated Slack support channel
> * Guaranteed SLAs
> * Custom legal terms
> * Annual invoicing

See [Plans and limits](https://docs.braintrust.dev/plans-and-limits.md) for a complete feature comparison.

## Downgrade your plan

> [tab] Pro -> Starter
>
> > [!WARNING]
> >
> > Before downgrading, ensure your usage fits within [Starter plan limits](https://docs.braintrust.dev/plans-and-limits.md#usage-limits). If your usage is higher than these limits when you downgrade, you'll be charged on-demand usage rates at the Starter tier pricing (which are higher than Pro rates).
>
> To downgrade from Pro to Starter:
>
> 1. Go to \*\* Settings\*\* > [\*\* Billing\*\*](https://www.braintrust.dev/app/~/configuration/billing).
> 2. Under **Current plan**, click **Adjust plan**.
> 3. In the plan selection dialog, click **Downgrade to starter**.
> 4. Review what will change when you downgrade.
> 5. Select a downgrade reason.
> 6. Click **Downgrade**.
>
> When you downgrade from Pro to Starter, the change is scheduled for the end of your current billing period. You'll keep access to Pro features until then. You can cancel the scheduled downgrade any time before the billing period ends from the Billing page.
>
> | Feature | Pro → Starter change |
> | - | - |
> | Custom dashboards (Build your own dashboards and custom charts to track metrics specific to your use case. The built-in Cost and quality dashboard is available on all plans.) | Unlimited → Keep existing, can't edit, duplicate, or create new |
> | Environments (Separate development, staging, and production data within your projects.) | Unlimited → Keep and edit existing, can't create new |
> | Human review scorers (Configure custom scoring workflows where human reviewers can provide feedback on traces.) | Unlimited per project → Limited to 1 per project |
> | Permission groups (Role-based access control for granular permissions management.) | Owner/Engineer/Viewer → Owner only for new projects |
>
> | Usage type | Pro → Starter change |
> | - | - |
> | Processed data | 5 GB/month, then \$3/GB → 1 GB/month, then \$4/GB |
> | Scores | 50k/month, then \$1.50/1k → 10k/month, then \$2.50/1k |
> | [Model credits](https://docs.braintrust.dev/plans-and-limits.md#usage-limits) | \$100/month → \$10/month. Overage rates unchanged. |
> | Data retention | 30-day retention (extendable up to 180-day retention) → 14-day retention |

> [tab] Enterprise -> Pro/Starter
>
> Enterprise customers on annual contracts cannot downgrade until the contract term ends.
>
> To discuss your options:
>
> 1. [Contact Braintrust support](mailto:support@braintrust.dev).
> 2. Discuss your situation and potential solutions.
> 3. Review contract terms and renewal options.
>
> When your Enterprise contract ends, you can choose to:
>
> * Renew at a different tier (Pro or Enterprise)
> * Move to a month-to-month Pro plan
> * Move to the Starter plan
>
> Enterprise features and custom limits will remain active until the end of your contract term.
>
> > [!WARNING]
> >
> > Before downgrading, ensure your usage fits within [Pro or Starter plan limits](https://docs.braintrust.dev/plans-and-limits.md#usage-limits). If your usage is higher than plan limits when you move to a new tier, you'll be charged on-demand usage rates.

## Redeem a coupon

On Starter with on-demand billing and Pro plans, you can redeem coupon codes to apply discounts to your subscription.

To redeem a coupon:

1. Go to ** Settings** > [** Billing**](https://www.braintrust.dev/app/~/configuration/billing).
2. Under **Current plan**, click **Redeem coupon**.
3. Enter your coupon code.
4. Click **Redeem**.

The discount appears on your billing page after the coupon is applied.

> [!NOTE]
>
> The **Redeem coupon** button is disabled when a plan change is already scheduled on your subscription. Contact [support@braintrust.dev](mailto:support@braintrust.dev) for assistance.

## Legacy plans

> [!NOTE]
>
> If you're on a legacy plan (signed up before March 2026), see [Legacy plans FAQ](https://docs.braintrust.dev/admin/billing/faq.md#legacy-plans) for details on how plan changes affect your existing features.

## Next steps

* [Plans and limits](https://docs.braintrust.dev/plans-and-limits.md) — Compare plans and understand usage limits
* [Monitor usage](https://docs.braintrust.dev/admin/billing/monitor-usage.md) — Track your usage and costs
* [Billing FAQ](https://docs.braintrust.dev/admin/billing/faq.md) — Common questions about pricing and billing
* [Contact sales](https://www.braintrust.dev/contact) — Discuss Enterprise plans or custom requirements


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.