You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx
+22-11Lines changed: 22 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ Add-on credits extend your AI usage beyond the included monthly quota in your pl
17
17
18
18
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.
19
19
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**.
21
21
22
22
:::caution
23
23
**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
79
79
80
80
#### Teams using Add-on Credits
81
81
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.
83
83
84
-
Team admins can manage:
84
+
Team admins manage Reload credit settings for the team in **Settings** > **Billing and usage**:
85
85
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.
90
89
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**
92
91
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:
94
93
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
+
:::
97
104
98
105
### Plan changes and cancellations
99
106
100
107
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.
101
108
102
109
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.
103
110
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
+
104
115
:::note
105
116
All unused Add-on Credits remain valid for 12 months from purchase, as long as you have an active subscription. 
Copy file name to clipboardExpand all lines: src/content/docs/support-and-community/plans-and-billing/credits.mdx
+19Lines changed: 19 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -130,3 +130,22 @@ The following scenarios do **not** use Cloud Agent Credits:
130
130
131
131
***Local agent runs** — Using `oz agent run` on your local machine
132
132
***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