Skip to content

Commit 5df54ab

Browse files
hongyi-chenoz-agent
andcommitted
Update Reload credits + credits page for May 2026 pricing
- add-on-credits.mdx: User-scoped Reload credits replace pooled team credits on Build/Max/Business self-serve plans. Documents team-wide spend cap, admin-managed auto-reload semantics, and the service account / team-scoped API key billing waterfall to the team admin. Adds a grandfathering callout for pre-May 2026 pooled credits and a 'leaving a paid team' clause under plan changes. Strips legacy '1,500 credits per team member' framing. - credits.mdx: Adds a 'Service account and team-scoped API key billing' section covering both self-serve (waterfall: admin's included credits -> admin's Reload credits, gated by auto-reload + team-wide spend cap) and Enterprise (draws from team Enterprise pool, per contract terms). Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent 4ecda11 commit 5df54ab

2 files changed

Lines changed: 41 additions & 11 deletions

File tree

src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx

Lines changed: 22 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Add-on credits extend your AI usage beyond the included monthly quota in your pl
1717

1818
If you’ve enabled **Auto reload**, new credits will be added automatically and billed based on your selected configuration of monthly spending limit and selected purchase amount.
1919

20-
Add-on credits are available for Build, Business, and Enterprise plans (with custom pricing for Enterprise). These credits **roll over across billing cycles** and remain valid for **12 months from the purchase date**.
20+
Add-on credits are available for Build, Max, Business, and Enterprise plans (with custom pricing for Enterprise). These credits **roll over across billing cycles** and remain valid for **12 months from the purchase date**.
2121

2222
:::caution
2323
**Legacy plans (Pro, Turbo, Lightspeed) do not support Add-on Credits.** If you're on a legacy plan, you cannot purchase or auto-reload Add-on Credits. To access Add-on Credits, upgrade to the [Build plan](https://app.warp.dev/upgrade). For additional usage on legacy plans, see [Overages (Legacy)](/support-and-community/plans-and-billing/overages-legacy/).
@@ -79,28 +79,39 @@ You can track your remaining credits and spending in the credits transparency fo
7979

8080
#### Teams using Add-on Credits
8181

82-
For teams on Build or Business plans, **Add-on Credits are shared across all members.** All team credit settings can be managed in `Settings → Billing and usage` by the admin of the team.
82+
On Build, Max, and Business self-serve plans, Reload credits are tied to individual users — they are no longer pooled across the team. Each team member's Reload credits draw down only for their own usage.
8383

84-
Team admins can manage:
84+
Team admins manage Reload credit settings for the team in **Settings** > **Billing and usage**:
8585

86-
* Enabling or disabling Auto reload
87-
* Adjusting monthly spend limits
88-
* Choosing Add-on credit increments
89-
* Viewing usage and spending breakdowns
86+
* **Team-wide spend cap** — Sets the maximum amount the team can spend on Reload credits per calendar month, applied across all members.
87+
* **Auto-reload** — When enabled, the admin selects a Reload denomination for the team. Warp automatically purchases that denomination for any user whose Reload balance drops below 100 credits, subject to the team-wide spend cap. While auto-reload is on, individual users cannot purchase Reload credits manually.
88+
* **Manual purchases** — When auto-reload is off, eligible team members can purchase Reload credits for themselves, as long as the team stays below the team-wide spend cap.
9089

91-
Each user on the team has their own monthly credit limit, **but any usage beyond that personal quota draws from the shared team credits**. These shared credits are tracked and billed collectively at the team level.
90+
**Service account and team-scoped API key requests**
9291

93-
For example, if your plan includes 1,500 credits per team member:
92+
When a request can't be attributed to an individual user — for example, one driven by a service account or a team-scoped API key — Warp bills the usage to the team admin:
9493

95-
* If **User A** reaches their 1,500 limit, any further usage will draw from shared Add-on Credits.
96-
* If **User B** has only used 200 credits, their remaining quota is unaffected, but User A will consume the team's shared credits.
94+
1. Warp first consumes the admin's included monthly credits.
95+
2. After those are used, Warp draws from the admin's Reload credits.
96+
3. If auto-reload is enabled, service-account usage can trigger auto-reload for the admin's Reload pool, subject to the team-wide spend cap.
97+
4. If the admin has no available credits and auto-reload is off, the request is blocked.
98+
99+
:::caution
100+
**Grandfathering for pre-May 2026 pooled credits**
101+
102+
Pooled Add-on credits purchased before May 14, 2026 remain available to the team and are consumed first when team members exceed their included monthly credits. No new pooled credits will be added — Reload credit purchases on or after May 14, 2026 are attributed to individual users.
103+
:::
97104

98105
### Plan changes and cancellations
99106

100107
Any purchased Add-on Credits remain in your account and can continue to be used for up to 12 months after purchase, as long as you have an active subscription.
101108

102109
If you move to the Free plan, you'll lose access to any previously purchased Add-on Credits and won't be able to use them. You also can't buy additional Add-on Credits until you're subscribed again.
103110

111+
**Leaving a paid team**
112+
113+
If you leave a paid team, you lose access to the Reload credits attributed to you under that team. If you later rejoin the same paid team, you regain access to any non-expired Reload credits that were attributed to you.
114+
104115
:::note
105116
All unused Add-on Credits remain valid for 12 months from purchase, as long as you have an active subscription.&#x20;
106117
:::

src/content/docs/support-and-community/plans-and-billing/credits.mdx

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,3 +130,22 @@ The following scenarios do **not** use Cloud Agent Credits:
130130

131131
* **Local agent runs** — Using `oz agent run` on your local machine
132132
* **Self-hosted compute** — Using `oz agent run` on GitHub Actions, CI/CD pipelines, or other self-hosted infrastructure
133+
134+
### Service account and team-scoped API key billing
135+
136+
When a request can't be attributed to an individual user — for example, one driven by a service account or a team-scoped API key — Warp bills the usage to the team admin's account.
137+
138+
#### Self-serve plans
139+
140+
On Build, Max, and Business plans, the billing waterfall for service-account and team-scoped API key requests is:
141+
142+
1. Warp first consumes the admin's included monthly credits.
143+
2. After those are used, Warp draws from the admin's Reload credits.
144+
3. If auto-reload is enabled for the team, service-account usage can trigger auto-reload for the admin's Reload pool, subject to the team-wide spend cap.
145+
4. If the admin has no available credits and auto-reload is off, the request is blocked.
146+
147+
For details on auto-reload, manual purchases, and the team-wide spend cap, see [Add-on Credits](/support-and-community/plans-and-billing/add-on-credits/).
148+
149+
#### Enterprise plans
150+
151+
On Enterprise plans, service-account and team-scoped API key usage draws from the team's Enterprise credit pool. Overage and pay-as-you-go behavior follows the terms of your Enterprise contract.

0 commit comments

Comments
 (0)