Limits
Account plan limits
Feature | Free | Paid (Bundled and Unbound) |
---|---|---|
Subrequests | 50/request | 50/request (Bundled), 1000/request (Unbound) |
Simultaneous outgoing connections/request |
6 | 6 |
Environment variables | 64/Worker | 128/Worker |
Environment variable size |
5 KB | 5 KB |
Worker size | 1 MB | 10 MB |
Worker startup time | 200 ms | 200 ms |
Number of Workers | 100 | 500 |
Number of Cron Triggers per Worker |
3 | 3 |
Number of Cron Triggers per account |
5 | 250 |
Request limits
URLs have a limit of 16 KB.
Request headers observe a total limit of 32 KB, but each header is limited to 16 KB.
Cloudflare has network-wide limits on the request body size. This limit is tied to your Cloudflare Account’s plan, which is separate from your Workers plan. When the request body size of your POST/PUT/PATCH requests exceed your plan’s limit, the request is rejected with a (413) Request entity too large
error.
Cloudflare Enterprise customers may contact their account team or Cloudflare Support to have a request body limit beyond 500 MB.
Cloudflare Plan | Maximum body size |
---|---|
Free | 100MB |
Pro | 100MB |
Business | 200MB |
Enterprise | 500MB (by default) |
Response limits
Cloudflare does not enforce response limits, but cache limits for Cloudflare’s CDN are observed. Maximum file size is 512 MB for Free, Pro, and Business customers and 5 GB for Enterprise customers.
Worker limits
Feature | Free | Bundled Usage Model | Unbound Usage Model | |
---|---|---|---|---|
Request | 100,000 requests/day 1000 requests/min |
none | none | |
Worker memory | 128 MB | 128 MB | 128 MB | |
CPU time | 10 ms | 50 ms HTTP request 50 ms Cron Trigger |
30 s HTTP request 15 min Cron Trigger 15 min Queue Consumer |
|
Duration | none | none | none |
Duration
Duration is a measurement of wall-clock time — the total amount of time from the start to end of an invocation of a Worker. There is no hard limit on the duration of a Worker. As long as the client that sent the request remains connected, the Worker can continue processing, making subrequests, and setting timeouts on behalf of that request. When the client disconnects, all tasks associated with that client request are canceled. Use event.waitUntil()
to delay cancellation for another 30 seconds or until the promise passed to waitUntil()
completes.
CPU time
CPU time is the amount of time the CPU actually spends doing work, during a given request. Most Workers requests consume less than a millisecond of CPU time. It is rare to find normally operating Workers that exceed the CPU time limit.
KV limits
Feature | Free | Paid |
---|---|---|
Reads | 100,000 reads per day | unlimited |
Writes to different keys | 1,000 writes per day | unlimited |
Writes to same key | 1 per second | 1 per second |
Operations/worker invocation | 1000 | 1000 |
Namespaces | 100 | 100 |
Storage/account | 1 GB | unlimited |
Storage/namespace | 1 GB | unlimited |
Keys/namespace | unlimited | unlimited |
Key size | 512 bytes | 512 bytes |
Key metadata | 1024 bytes | 1024 bytes |
Value size | 25 MiB | 25 MiB |
Cache API limits
Feature | Free | Bundled |
---|---|---|
Max object size | 512 MB | 512 MB |
Calls/request | 50 | 50 |
Storage/request | 5 GB | 5 GB |
Durable Objects limits
Durable Objects are only available on the Workers Paid plan.
Feature | Limit |
---|---|
Number of objects | unlimited |
Storage per account | 50 GB (can be raised by contacting Cloudflare) |
Storage per class | unlimited |
Storage per object | unlimited |
Key size | 2048 bytes |
Value size | 128 KiB |
WebSocket message size | 1 MiB |
CPU per request | 30s |
Request
Workers automatically scale onto thousands of Cloudflare global network servers around the world. There is no general limit to the number of requests per second Workers can handle.
Cloudflare’s abuse protection methods do not affect well-intentioned traffic. However, if you send many thousands of requests per second from a small number of client IP addresses, you can inadvertently trigger Cloudflare’s abuse protection. If you expect to receive 1015
errors in response to traffic or expect your application to incur these errors, contact your Cloudflare account team to increase your limit.
The burst rate and daily request limits apply at the account level, meaning that requests on your *.workers.dev
subdomain count toward the same limit as your zones. Upgrade to a
Paid plan to automatically lift these limits.
Burst rate
Accounts using the Workers Free plan are subject to a burst rate limit of 1,000 requests per minute. Users visiting a rate limited site will receive a Cloudflare 1015
error page. However if you are calling your Worker programmatically, you can detect the rate limit page and handle it yourself by looking for HTTP status code 429
.
Workers being rate-limited by Anti-Abuse Protection are also visible from the Cloudflare dashboard:
- Log in to the Cloudflare dashboard and select your account and your website.
- Select Security > Events > scroll to Activity log.
- Review the log for a Web Application Firewall block event with a
ruleID
ofworker
.
Daily request
Accounts using the Workers Free plan are subject to a daily request limit of 100,000 requests. Free plan daily requests counts reset at midnight UTC. A Worker that fails as a result of daily request limit errors can be configured by toggling its corresponding route in two modes: 1) Fail open and 2) Fail closed.
Fail open
Routes in fail open mode will bypass the failing Worker and prevent it from operating on incoming traffic. Incoming requests will behave as if there was no Worker.
Fail closed
Routes in fail closed mode will display a Cloudflare 1027
error page to visitors, signifying the Worker has been temporarily disabled. Cloudflare recommends this option if your Worker is performing security related tasks.
Memory
Only one Workers instance runs on each of the many global Cloudflare global network servers. Each Workers instance can consume up to 128 MB of memory. Use global variables to persist data between requests on individual nodes; note however, that nodes are occasionally evicted from memory.
If a Worker processes a request that pushes the Worker over the 128MB limit, the Cloudflare Workers runtime may cancel one or more requests. To view these errors, as well as CPU limit overages:
- Log in to the Cloudflare dashboard and select your account.
- Select Workers & Pages and in Overview, select the Worker you would like to investigate.
- Find Invocation Statuses and examine Exceeded Resources.
Use the TransformStream API to stream responses if you are concerned about memory usage. This avoids loading an entire response into memory.
Subrequests
A subrequest is any request that a Worker makes to another Internet resource using the Fetch API.
How many subrequests can I make?
The limit for subrequests a Worker can make is 50 per request on the Bundled usage model or 1000 per request on the Unbound usage model. Each subrequest in a redirect chain counts against this limit. This means that the number of subrequests a Worker makes could be greater than the number of fetch(request)
calls in the Worker.
For subrequests to internal services like Workers KV and Durable Objects, the subrequest limit is 1000 per request, regardless of usage model.
How long can a subrequest take?
There is no set limit on the amount of real time a Worker may use. As long as the client which sent a request remains connected, the Worker may continue processing, making subrequests, and setting timeouts on behalf of that request.
When the client disconnects, all tasks associated with that client’s request are proactively canceled. If the Worker passed a promise to event.waitUntil()
, cancellation will be delayed until the promise has completed or until an additional 30 seconds have elapsed, whichever happens first.
Simultaneous open connections
While handling a request, each Worker is allowed to have up to six connections open simultaneously. The connections opened by the following API calls all count toward this limit:
- the
fetch()
method of the Fetch API. get()
,put()
,list()
, anddelete()
methods of Workers KV namespace objects.put()
,match()
, anddelete()
methods of Cache objects.list()
,get()
,put()
,delete()
, andhead()
methods of R2.send()
andsendBatch()
, methods of Queues.- Opening a TCP socket using the
connect()
API.
Once a Worker has six connections open, it can still attempt to open additional connections. However, these attempts are put in a pending queue — the connections will not be initiated until one of the currently open connections has closed. Since earlier connections can delay later ones, if a Worker tries to make many simultaneous subrequests, its later subrequests may appear to take longer to start.
If the system detects that a Worker is deadlocked on open connections — for example, if the Worker has pending connection attempts but has no in-progress reads or writes on the connections that it already has open — then the least-recently-used open connection will be canceled to unblock the Worker. If the Worker later attempts to use a canceled connection, an exception will be thrown. These exceptions should rarely occur in practice, though, since it is uncommon for a Worker to open a connection that it does not have an immediate use for.
Environment variables
The maximum number of environment variables (secret and text combined) for a Worker is 128 variables on the Paid plan, and 64 variables on the Free plan. There is no limit to the number of environment variables per account.
Each environment variable has a size limitation of 5 KB.
Worker size
A Worker can be up to 10 MB in size after compression, and up to 1 MB for free accounts. You can request adjustments to limits that conflict with your project goals by contacting Cloudflare. To request an increase to a limit, complete the Limit Increase Request Form and we will contact you with next steps.
Worker startup time
A Worker must be able to be parsed and execute its global scope (top-level code outside of any handlers) within 200 ms. Script size can impact startup because there’s more code to parse and evaluate. Avoiding expensive code in the global scope can keep startup efficient as well. You can request adjustments to limits that conflict with your project goals by contacting Cloudflare. To request an increase to a limit, complete the Limit Increase Request Form and we will contact you with next steps.
Number of Workers
Unless otherwise negotiated as a part of an enterprise level contract, all paid Workers accounts are limited to a maximum of 500 Workers at any given time. Free Workers accounts are limited to a maximum of 100 Workers at any given time.
Number of routes per zone
Each zone has a limit of 1,000 routes. If you require more than 1,000 routes on your zone, consider using Workers for Platforms or request an increase to this limit by completing the Limit Increase Request Form.
Number of routed zones per Worker
When configuring routing, the maximum number of zones that can be referenced by a Worker is 1,000. If you require more than 1,000 zones on your Worker, consider using Workers for Platforms or request an increase to this limit by completing the Limit Increase Request Form.
Cache API
-
50 total
put()
,match()
, ordelete()
calls per-request, using the same quota asfetch()
-
5 GBs total
put()
per-request
Image Resizing with Workers
When using Image Resizing with Workers, refer to Image Resizing documentation for more information on the applied limits.
Log size
- You can emit a maximum of 128 KB of data (across
console.log()
statements, exceptions, request metadata and headers) to the console for a single request. After you exceed this limit, further context associated with the request will not be recorded in logs, appear when tailing logs of your Worker, or within a Tail Worker. - Refer to the Workers Trace Event Logpush documentation for information on the maximum size of fields sent to logpush destinations.