# Add-on Credits
Add-on credits replace Warp's old [pay-as-you-go Overages](https://docs.warp.dev/support-and-community/plans-and-billing/overages-legacy). They let you continue using premium AI models even after you've reached your monthly credit limit — at lower rates and with more control over spending.
You can manage and purchase Add-on credits directly in **Settings** > **Billing and usage**.
### How do Add-on credits work?
Add-on credits extend your AI usage beyond the included monthly quota in your plan. Once your plan’s credits are used up, Warp will automatically begin drawing from your available Add-on credits.
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.
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**.
{% hint style="warning" %}
**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)](https://docs.warp.dev/support-and-community/plans-and-billing/overages-legacy).
{% endhint %}
### Purchasing Add-on credits
You have two options for purchasing more credits:
#### 1. Buy on-demand
You can purchase additional Add-on credits at any time directly within the app under **Settings** > **Billing and usage**. Buying more credits upfront provides a larger discount.
The table below shows the available credit denominations, their prices, and corresponding discounts:
Credits
Price (USD)
Price per Credit
Discount
400
$10
$0.025
Base rate
1,000
$20
$0.020
20% off
3,000
$50
$0.016
~35% off
6,500
$100
$0.0153
~40% off
#### 2. Enable auto-reload
Auto reload automatically purchases more credits whenever your balance reaches **100 credits**, ensuring uninterrupted access to premium AI features.
By default, **Auto reload is disabled for new subscribers**. When you turn it on, it starts with a **$200 monthly spend limit**, which you can adjust anytime in **Settings** > **Billing and usage**.
Auto reload uses the same denominations and discounts as manual purchases. The denomination you select (e.g., 400, 1,000, 3,000, or 6,500 credits) will repeat each time your balance is depleted, up to your monthly spending limit. Larger denominations offer up to \~40% off per credit.
{% hint style="info" %}
You can opt in and choose your reload amount when subscribing to a paid plan at [app.warp.dev/upgrade](https://app.warp.dev/upgrade), or change your configuration anytime in **Settings** > **Billing and usage**.
{% endhint %}
{% hint style="warning" %}
Add-on credit auto reload will be enabled by default for some legacy plan users when they transition to the Build plan. Please see more in our [Pricing FAQs](https://docs.warp.dev/support-and-community/pricing-faqs#what-happens-to-my-current-plan-pro-turbo-lightspeed).
{% endhint %}
#### **Configuring a monthly spend limit**
Your monthly spend limit sets the maximum amount you can spend on Add-on credits in a single calendar month. This ensures you have full control over your AI usage costs while still allowing flexibility for automatic top-ups when needed, keeping your workflow uninterrupted.
* The default limit is $200, but you can increase or decrease it anytime in **Settings** > **Billing and usage**.
* **If a credit purchase would exceed your limit, it won’t process** — you’ll need to either raise your limit or choose a smaller Add-on credit amount.
* Once your limit is reached, no additional Add-on Credit purchases (manual or automatic) will occur until:
* The next calendar month begins, or
* You update your limit in settings.
{% hint style="warning" %}
Your monthly spend limit is separate from your billing cycle (which determines when your subscription renews).\
\
The limit resets automatically at the start of each calendar month, so you can manage recurring AI usage with predictable spending and clear visibility into your costs.
{% endhint %}
### Billing and credit usage
When your monthly credit balance renews:
1. Warp first consumes your included monthly plan credits (e.g., Build plan credits).
2. After those are used, Warp continues to draw from any available Add-on Credits.
3. If your Add-on Credits run out and Auto reload is enabled, Warp will automatically purchase more up to your monthly limit.
You can track your remaining credits and spending in the credits transparency footer and in **Settings** > **Billing and usage**.
#### Teams using Add-on Credits
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.
Team admins can manage:
* Enabling or disabling Auto reload
* Adjusting monthly spend limits
* Choosing Add-on credit increments
* Viewing usage and spending breakdowns
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.
For example, if your plan includes 1,500 credits per team member:
* If **User A** reaches their 1,500 limit, any further usage will draw from shared Add-on Credits.
* If **User B** has only used 200 credits, their remaining quota is unaffected, but User A will consume the team's shared credits.
### Plan changes and cancellations
If you upgrade, downgrade, or switch plans, any purchased Add-on Credits remain in your account and can continue to be used.
If you move to the Free plan, you’ll retain access to any previously purchased Add-on Credits and be able to use them, as long as telemetry is enabled, but can’t buy additional ones until you upgrade again.
{% hint style="warning" %}
You won't be able to use the remaining Add-on Credits with telemetry disabled since we aren't able to properly track credit usage. See more on the telemetry settings in our [Privacy page](https://docs.warp.dev/support-and-community/privacy-security-and-licensing/privacy).
{% endhint %}
{% hint style="info" %}
All unused Add-on Credits remain valid for 12 months from purchase.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.warp.dev/support-and-community/plans-and-billing/add-on-credits.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
