diff --git a/.agents/references/terminology.md b/.agents/references/terminology.md index edf66270..6aad15a8 100644 --- a/.agents/references/terminology.md +++ b/.agents/references/terminology.md @@ -248,6 +248,8 @@ For the summary of the most critical terms (core features, Oz terms, terms to av ## Billing and credits - **Add-on Credits** — capitalized as a product feature name +- **Auto-reload** — the setting that automatically purchases another add-on credit pack when a user's balance drops below 100 credits. Hyphenated; capitalize the first letter only at the start of a sentence, bullet, or bolded list term. +- **team-wide spend cap** — the admin-configured monthly ceiling on add-on credit spending across a whole team. Use instead of "budget" or "credit limit" when describing the cap. The per-account wording "monthly spend limit" refers to the same setting in single-user contexts. - **compute credits** — lowercase common noun; capitalize the first letter only at the start of a sentence or bullet. The compute bucket, consumed when an agent run uses Warp-hosted compute. Use alongside AI credits and platform credits when describing credit types. - **cloud agent credits** — lowercase common noun; capitalize the first letter only at the start of a sentence or bullet. Credits consumed by cloud agents, in contrast with local agent credits. Refers to the same compute bucket as compute credits; choose the term that fits the framing. - **platform credits** — lowercase common noun; capitalize the first letter only at the start of a sentence or bullet. The platform-infrastructure bucket, consumed for every cloud agent run plus local runs with customer-supplied inference. diff --git a/src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx b/src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx index 2845adbe..1f4441f1 100644 --- a/src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx @@ -2,12 +2,12 @@ title: Add-on credits description: >- Purchase add-on credits to keep using premium AI models after reaching your - monthly credit limit. + monthly credit limit, or to top up on the Free plan without subscribing. --- -Add-on credits 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. +Add-on credits 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 also buy them on the Free plan without subscribing. -You can manage and purchase add-on credits directly in **Settings** > **Billing and usage**. +In the Warp app, you can manage and purchase add-on credits directly in **Settings** > **Billing and usage**. ![Add-on credits management surface under **Settings** > **Billing and usage**.](../../../../assets/support-and-community/reload-credits.png) @@ -17,10 +17,20 @@ Add-on credits extend your AI usage beyond the included monthly quota in your pl 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, Max, Business, and Enterprise plans (with custom pricing for Enterprise). On self-serve plans (Build, Max, and Business), add-on credits are scoped to each individual user; Enterprise uses a team-pooled model. These credits **roll over across billing cycles** and remain valid for **12 months from the purchase date**. +Add-on credits are available on every self-serve plan — Free, Build, Max, and Business — plus Enterprise. The Free plan buys the same packs at a higher rate than paid plans; see [Warp pricing](https://www.warp.dev/pricing) for current rates. On self-serve plans, add-on credits are scoped to each individual user; Enterprise uses a team-pooled model. These credits **roll over across billing cycles** and remain valid for **12 months from the purchase date**. Add-on credits draw from the same pool as [platform credits](/support-and-community/plans-and-billing/platform-credits/) and compute credits, so a single balance covers all three credit types. +### Who can purchase add-on credits + +Any active member of a team can purchase add-on credits for their own usage. You don't need to be a team admin, and you don't need a paid subscription — Free plan users can buy packs and spend them on any model. Credits you buy are scoped to you, so they only draw down for your own usage. + +Team admins keep the team-level controls: + +* **Team-wide monthly spend cap** - Caps what the whole team can spend on add-on credits per calendar month, across all members. +* **Auto-reload** - While an admin has auto-reload on, individual members can't purchase add-on credits manually. +* **The team's payment method** - Every purchase charges the payment method saved for the team, and only admins can change or remove it. See [Which card is charged when a team member buys add-on credits?](/support-and-community/plans-and-billing/pricing-faqs/#which-card-is-charged-when-a-team-member-buys-add-on-credits). + ### Purchasing add-on credits You have two options for purchasing more credits: @@ -73,7 +83,7 @@ You can track your remaining credits and spending in the credits transparency fo #### Teams using add-on credits -On Build, Max, and Business self-serve plans, add-on credits are scoped to individual users. Each team member's add-on credits draw down only for their own usage. +On self-serve plans (Free, Build, Max, and Business), add-on credits are scoped to individual users. Each team member's add-on credits draw down only for their own usage. Team admins manage add-on credit settings for the team in **Settings** > **Billing and usage**: @@ -85,12 +95,12 @@ For how cloud agent runs that aren't initiated by a specific team member (schedu ### Plan changes and cancellations -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. +Any purchased add-on credits remain in your account and can continue to be used for up to 12 months after purchase. -If you move to the Free plan, your remaining add-on credits aren't removed. They keep their original 12-month expiration from the purchase date, but you can't use them. When you re-subscribe, on the same team, you regain access to any unused, non-expired credits. You also can't buy additional add-on credits until you're subscribed again. +If you move to the Free plan, your remaining add-on credits aren't removed and they keep their original 12-month expiration from the purchase date. You can keep spending them on the Free plan and buy more, though new purchases use the Free plan rate until you re-subscribe. :::caution -Add-on credits are tied to your team. Leaving the team, being removed by an admin, or having the team deleted revokes your access to any credits tied to that team. Premium models require an active paid plan. +Add-on credits are tied to your team. Leaving the team, being removed by an admin, or having the team deleted revokes your access to any credits tied to that team. ::: #### When team membership changes @@ -102,5 +112,5 @@ Add-on credits are tied to the team they were purchased under. The flows below d * **An admin deletes the team** - Any remaining add-on credits must be used or removed before a team can be deleted. Contact [support@warp.dev](mailto:support@warp.dev) if you need help with this. :::note -All unused add-on credits remain valid for 12 months from purchase. Using them requires an active paid subscription on the same team. +All unused add-on credits remain valid for 12 months from purchase, and they stay tied to the team they were purchased under. ::: diff --git a/src/content/docs/support-and-community/plans-and-billing/credits.mdx b/src/content/docs/support-and-community/plans-and-billing/credits.mdx index dc6c6fa5..41d4bfb4 100644 --- a/src/content/docs/support-and-community/plans-and-billing/credits.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/credits.mdx @@ -43,7 +43,7 @@ You can view your total credit usage, along with other billing details, in **Set * **Seat-level allocation**: On team plans, credit limits apply per seat — each team member has their own allowance. Individual users (not on a team) also have their own credit allocation. * **Cloud agents and integrations**: Individual users can run cloud agents via the CLI and API, drawing from their Warp credits. Slack and Linear integrations require team membership. -* **Credit limits by plan**: The Free plan doesn't include bundled AI usage for the Warp Agent. To use the Warp Agent, [upgrade to a paid plan](https://www.warp.dev/pricing) or bring your own inference with [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), a [custom inference endpoint](/agents/inference/custom-inference-endpoint/), or a [SuperGrok or X Premium subscription](/agents/inference/grok-subscription/). On paid plans, once you reach your monthly credit limit you can continue using AI with usage-based billing via [add-on credits](/support-and-community/plans-and-billing/add-on-credits/). +* **Credit limits by plan**: The Free plan doesn't include bundled AI usage for the Warp Agent. To use the Warp Agent, [upgrade to a paid plan](https://www.warp.dev/pricing), buy [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) without subscribing, or bring your own inference with [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), a [custom inference endpoint](/agents/inference/custom-inference-endpoint/), or a [SuperGrok or X Premium subscription](/agents/inference/grok-subscription/). On paid plans, once you reach your monthly credit limit you can continue using AI with usage-based billing via [add-on credits](/support-and-community/plans-and-billing/add-on-credits/). #### **Other features that use credits** diff --git a/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx b/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx index 161d44f7..91ccbae2 100644 --- a/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx @@ -10,7 +10,7 @@ sidebar: Warp offers flexible, pay-as-you-go plans designed for individual developers, teams, and enterprises. -Paid plans include a monthly allowance of credits that power features such as code generation, debugging, and multi-agent workflows. The Free plan doesn't include bundled AI usage for the Warp Agent. To use the Warp Agent, [upgrade to a paid plan](https://www.warp.dev/pricing) or bring your own inference with [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), a [custom inference endpoint](/agents/inference/custom-inference-endpoint/), or a [SuperGrok or X Premium subscription](/agents/inference/grok-subscription/). +Paid plans include a monthly allowance of credits that power features such as code generation, debugging, and multi-agent workflows. The Free plan doesn't include bundled AI usage for the Warp Agent. To use the Warp Agent, [upgrade to a paid plan](https://www.warp.dev/pricing), buy [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) without subscribing, or bring your own inference with [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), a [custom inference endpoint](/agents/inference/custom-inference-endpoint/), or a [SuperGrok or X Premium subscription](/agents/inference/grok-subscription/). :::note See [Warp pricing](https://www.warp.dev/pricing) for the latest plans and what’s included in each offering. @@ -49,7 +49,8 @@ After 15 days, we will refund you for the remaining full months on your subscrip #### Add-on credits refund policy -* If you purchased [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) by mistake, you can receive a refund **as long as none of the credits have been used**. Warp cannot refund add-on credits if there has been any usage. Add-on credits remain available for up to **12 months** from the date of purchase. If you move to the Free plan, your remaining add-on credits aren't removed and keep the same expiration. You just can't use them until you re-subscribe on the same team. +* If you purchased [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) by mistake, you can receive a refund **as long as none of the credits have been used**. Warp cannot refund add-on credits if there has been any usage. Add-on credits remain available for up to **12 months** from the date of purchase, including if you move to the Free plan. +* Add-on credit purchases charge the payment method saved for your team, and any active team member can make one. If a purchase was billed to a card you didn't expect, see [Which card is charged when a team member buys add-on credits?](/support-and-community/plans-and-billing/pricing-faqs/#which-card-is-charged-when-a-team-member-buys-add-on-credits) before requesting a refund. :::caution Warp does not offer a formal guaranteed uptime Service Level Agreement (SLA). Live incidents can be monitored on our [**Status Page**](https://status.warp.dev/), and open issues are tracked on our [**GitHub Issues**](https://github.com/warpdotdev/Warp/issues). diff --git a/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx b/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx index bef7fd23..4b53cf1b 100644 --- a/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx @@ -174,7 +174,7 @@ Local agent runs on Free, Build, or Max — and local runs on Business or Enterp If you regularly run through your plan's monthly credit allowance, you have a few options: * **Upgrade to Max** — Designed for developers with heavier AI usage. Max includes a higher monthly credit allowance than Build, plus a better effective rate for credits than buying [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) on Build. See [Warp pricing](https://www.warp.dev/pricing) for current allowances. -* **Purchase add-on credits** — Top up your account on demand. Larger denominations have a better effective rate. Add-on credits roll over month-to-month and remain valid for 12 months from purchase. If you move to the Free plan, your remaining add-on credits aren't removed. You just can't use them until you re-subscribe on the same team. See [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) for current denominations. +* **Purchase add-on credits** — Top up your account on demand. Larger denominations have a better effective rate. Add-on credits roll over month-to-month and remain valid for 12 months from purchase, and they stay usable if you later move to the Free plan. See [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) for current denominations. * **Enable auto-reload** — Pick a denomination and a monthly spend cap, and Warp will automatically purchase add-on credits when your balance drops below 100 credits, up to your cap. * **Bring Your Own API Key (BYOK)** — Point Warp at your own OpenAI, Anthropic, or Google API key. Requests routed through BYOK don't consume Warp credits — you're billed directly by the model provider. See [Bring Your Own API Key](/agents/inference/bring-your-own-api-key/). On Business and Enterprise, platform credits may apply for local agent runs (billing starts July 1, 2026 on self-serve plans — see [When do platform credits start being charged on self-serve plans?](#when-do-platform-credits-start-being-charged-on-self-serve-plans)). * **Use a custom inference endpoint** — Route requests through any OpenAI-compatible endpoint (OpenRouter, LiteLLM, z.ai, an internal gateway, etc.) without spending Warp credits. See [Custom inference endpoint](/agents/inference/custom-inference-endpoint/). On Business and Enterprise, platform credits may apply for local agent runs (billing starts July 1, 2026 on self-serve plans — see [When do platform credits start being charged on self-serve plans?](#when-do-platform-credits-start-being-charged-on-self-serve-plans)). @@ -183,6 +183,45 @@ If you regularly run through your plan's monthly credit allowance, you have a fe For organization-scale needs (cloud-provider managed inference, granular admin controls, or higher seat counts), Enterprise plans include [Bring Your Own LLM (BYOLLM)](/enterprise/enterprise-features/bring-your-own-llm/). +### Can I buy credits on the Free plan without subscribing? + +Yes. Free plan users can buy the same [add-on credit](/support-and-community/plans-and-billing/add-on-credits/) packs as paid plans and spend them on any model, without a subscription. Free plan packs cost more per credit than the same packs on a paid plan — see [Warp pricing](https://www.warp.dev/pricing) for current rates. + +Buy from **Settings** > **Billing and usage** in the Warp app, or from the **Add-on credits** card on the [Warp upgrade page](https://app.warp.dev/upgrade). + +Credits you buy this way behave like any other add-on credits: they roll over, stay valid for 12 months from purchase, and remain usable if your team later moves between plans. + +### Who on my team can purchase add-on credits? + +Any active team member can purchase add-on credits for their own usage. Admin permissions aren't required, and the team doesn't need a paid subscription. Purchased credits are scoped to the buyer, so they only draw down for that person's usage. + +Two team-level settings still apply, and both are admin-only: + +* **Team-wide monthly spend cap** — Every purchase counts against one cap for the whole team per calendar month. Purchases that would exceed the cap are rejected. +* **Auto-reload** — While an admin has auto-reload on, individual members can't purchase add-on credits manually. + +Upgrading the team to a paid plan is still admin-only. A member who can't upgrade the team can still buy add-on credits for themselves. + +### Which card is charged when a team member buys add-on credits? + +Add-on credit purchases charge the payment method saved for the **team**, not a per-member card. That's whichever card the team already has on file — usually the one an admin entered when subscribing, or the one the first member entered when buying credits on a team that had no card yet. + +If the team has no saved payment method, the first purchase adds one and that card becomes the team's default. Later add-on credit purchases and auto-reload charge it. On a Free plan team, that means the first member to buy credits can end up supplying the card a teammate's later purchase is billed to. + +If you see an add-on credit charge you don't recognize: + +* Check **Settings** > **Billing and usage** in the Warp app for the team's add-on credit purchases this month. +* Ask a team admin to review the invoices in the billing portal, which lists each purchase and the member it was purchased for. See [How do I manage my billing?](#how-do-i-manage-my-billing). +* Email [billing@warp.dev](mailto:billing@warp.dev) if the charge still looks wrong. + +### How do I change or remove the card saved for my team? + +Team admins change or remove the saved card in the billing portal, reachable from **Settings** > **Billing and usage** in the Warp app or from the [Warp Admin Panel](https://app.warp.dev/admin/) on the web. See [How do I manage my billing?](#how-do-i-manage-my-billing) for both paths. + +Non-admin members can't open the billing portal. If you added a card to your team through a credit purchase and want it removed, ask a team admin to do it, or email [billing@warp.dev](mailto:billing@warp.dev). + +Admins who want to limit exposure without removing the card can lower the team-wide monthly spend cap under **Settings** > **Billing and usage**. Setting a lower cap bounds what the team can spend on add-on credits in a calendar month, no matter who makes the purchase. + ### How does auto-reload work for teams? Auto-reload prevents team members from getting blocked by credit exhaustion. It works the same way for individual and multi-seat paid plans, with one extra knob for teams. @@ -223,12 +262,13 @@ Enterprise plans support team-scoped credit pools, so this traffic draws from th ### Does the Free plan include AI usage? -The Free plan doesn't include bundled AI usage for the Warp Agent. To use the Warp Agent, you have two options: +The Free plan doesn't include bundled AI usage for the Warp Agent. To use the Warp Agent, you have three options: * **Upgrade to a paid plan** — paid plans include a monthly allowance of Warp-provided AI usage with no extra setup. See [Warp pricing](https://www.warp.dev/pricing). +* **Buy add-on credits** — purchase a credit pack without subscribing and spend it on any model. See [Can I buy credits on the Free plan without subscribing?](#can-i-buy-credits-on-the-free-plan-without-subscribing). * **Bring your own inference** — connect your own API key with [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), point Warp at a [custom inference endpoint](/agents/inference/custom-inference-endpoint/), or use a [SuperGrok or X Premium subscription](/agents/inference/grok-subscription/). Requests routed through your own inference don't consume Warp credits. -Without a paid plan or your own inference, conversations on the Free plan can't run on Warp-provided models. This includes conversations started from prompt suggestions in the input. +Without a paid plan, purchased add-on credits, or your own inference, conversations on the Free plan can't run on Warp-provided models. This includes conversations started from prompt suggestions in the input. ### Can I use a Free plan if I'm a developer at a large company or organization? @@ -394,7 +434,7 @@ Add-on credits are tied to the team that paid for them, so team-membership chang * **An admin removes you from a team**: You lose access to any add-on credits tied to that team. If you rejoin later, you regain access to any unused, non-expired credits. * **An admin deletes the team**: Any remaining add-on credits tied to the team are no longer usable by anyone. -Unused add-on credits remain valid for 12 months from purchase, as long as you have an active subscription. See [When team membership changes](/support-and-community/plans-and-billing/add-on-credits/#when-team-membership-changes) on the add-on credits page for full details. +Unused add-on credits remain valid for 12 months from purchase and stay tied to the team they were purchased under. See [When team membership changes](/support-and-community/plans-and-billing/add-on-credits/#when-team-membership-changes) on the add-on credits page for full details. #### Can I bring my own API key on the Free plan now? @@ -434,4 +474,5 @@ A short checklist to triage the May 2026 changes for your team: * **Check your seat count.** Go to **Settings** > **Teams** to see whether your team is at or above your plan's new seat limit. If you are, see [What if my team is already above the new seat limit?](#what-if-my-team-is-already-above-the-new-seat-limit). * **Set your team's add-on credit spend cap.** Under **Settings** > **Billing and usage**, configure the monthly cap that applies to add-on credit purchases across your team. Team members can now buy their own add-on credits, but every purchase counts against this cap. * **Let your team know add-on credits are user-scoped now.** Each member can purchase add-on credits for their own usage without affecting anyone else's balance. +* **Confirm which card your team has on file.** Every add-on credit purchase charges the team's saved payment method, including purchases made by members who aren't admins. Review it in the billing portal. See [Which card is charged when a team member buys add-on credits?](#which-card-is-charged-when-a-team-member-buys-add-on-credits). * **Plan for platform credits on July 1, 2026.** If your team is on Business and uses BYOK or a custom inference endpoint locally, those local runs will start consuming platform credits when the preview period ends. See [When do platform credits start being charged on self-serve plans?](#when-do-platform-credits-start-being-charged-on-self-serve-plans).