Spending limits and alerts

Set spending limits for Workers and Durable Objects, or receive email alerts when spending reaches a threshold. Support for more products is coming soon.

When a product reaches its spending limit, Cloudflare blocks supported operations until the next billing period or until you change the limit. Email alerts notify you without blocking usage.

Use these controls alongside AI Gateway spend limits to manage compute and AI inference costs across your application. AI Gateway supports per-user and per-model budgets for Workers AI and other AI providers, applied to requests routed through your gateway.

In the billing API, a spending limit or email alert is called a spend policy.

Choose how to configure spending limits and email alerts for Workers or Durable Objects:

• Dashboard: Set a spending limit for Workers or Durable Objects.
• cf CLI: Create and manage spending limits and email alerts from your terminal or coding agent.

Workers and Durable Objects each have a separate product-wide limit. A Workers limit does not include Durable Objects, Workers AI, Workers KV, R2, or other products used by your application.

Workers and Durable Objects limits cannot target an individual Worker, Durable Object namespace, or billing metric. Choose each limit for the combined usage of that product across your account.

Workers and Durable Objects limits use estimated usage charges for the product's current subscription billing period. Included usage is deducted before Cloudflare calculates these charges. Amounts are in US dollars.

Stored data can continue to incur charges while Durable Objects are paused. Reaching a limit does not cancel your subscription or remove existing stored data.

Your invoice is the final record of charges. Metering delays, operations already in progress, and enforcement failures can allow spend to exceed a limit.

You need permission to edit billing settings to manage limits. Before saving, review what stops for Workers or Durable Objects.

The limit applies to usage already recorded in the current period. For example, saving a $50 limit after the product has accrued $60 can trigger a pause as soon as Cloudflare evaluates the policy.

Use the cf CLI to create spending limits or email alerts, update or remove them, and review their history. The cf CLI guide includes setup instructions and commands you can copy and run.

Suppose you set a $50 spending limit for Workers for your account. Requests and CPU charges count together toward that limit, after included usage.

flowchart TD
    A["Workers usage charges below $40"] --> B["$40: near the $50 limit"]
    B --> C["$50 or more: limit reached"]
    C -->|"After the limit takes effect"| D["New Worker invocations blocked"]
    D --> E["Raise the limit above current spend<br/>or turn it off or remove it"]
    D --> G["Next billing period starts"]
    E --> F["Worker invocations resume"]
    G --> F

• At $40, the limit is Near limit: 80% of $50.
• At $50 or more, it is Limit reached. Blocking is not instantaneous.
• The Workers Paid subscription fee is charged separately.
• Durable Objects and other products have separate charges and controls. An application can still fail if it depends on a paused Worker.

Policies with an email address send notifications at 80% and 100% of the threshold. If spend jumps past both thresholds between evaluations, you may only receive the 100% notification.

The dashboard's limit status reflects a recorded threshold event. Limit reached does not confirm that blocking has finished propagating. On means the policy is enabled, not that the product is running.

Spending limits created in the dashboard do not automatically have an email recipient. To receive limit notifications, update the policy with a notification_email address.

To lift a spending limit before the period ends, use one of these options in Spend Management:

Changes can take a few minutes to apply. Further usage can incur charges once service resumes. Turning the same limit off and on does not reset this period's spend.

At the next subscription billing period, the block expires automatically. An enabled limit stays configured for the new period.

For example, if your subscription renews on the 15th, the limit resets on the 15th. It does not reset on the first day of each calendar month.

These actions only lift a block caused by a spending limit. They do not remove other account restrictions or product limits.

In Billing > Spend Management, the Audit log panel shows changes to your spending limits, including who made each change and when. These actions also appear in Cloudflare's account-wide Audit Logs.

Cloudflare also records when spending reaches 80% or 100% of a policy's threshold. These events happen automatically, without a user making an API request. Use the cf CLI to review configuration changes and threshold events. A threshold event does not confirm that blocking or email delivery succeeded.

• Workers spending limits — affected invocations, static assets, and errors.
• Durable Objects spending limits — storage, WebSockets, and alarms.
• Monitor billable usage — review usage-based costs across products.