Skip to content

Commit 39ffd2d

Browse files
docs: clarify scope and remove duplicate footnotes in limits pages (#27597)
Co-authored-by: opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com>
1 parent ca540c2 commit 39ffd2d

File tree

5 files changed

+82
-113
lines changed

5 files changed

+82
-113
lines changed

src/content/docs/d1/platform/limits.mdx

Lines changed: 9 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,17 @@ pcx_content_type: concept
33
title: Limits
44
sidebar:
55
order: 2
6-
76
---
87

9-
import { Render, Details } from "~/components";
8+
import { Render } from "~/components";
109

1110
| Feature | Limit |
1211
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
13-
| Databases | 50,000 (Workers Paid)[^1] / 10 (Free) |
12+
| Databases per account | 50,000 (Workers Paid) [^1] / 10 (Free) |
1413
| Maximum database size | 10 GB (Workers Paid) / 500 MB (Free) |
15-
| Maximum storage per account | 1 TB (Workers Paid)[^2] / 5 GB (Free) |
14+
| Maximum storage per account | 1 TB (Workers Paid) [^2] / 5 GB (Free) |
1615
| [Time Travel](/d1/reference/time-travel/) duration (point-in-time recovery) | 30 days (Workers Paid) / 7 days (Free) |
17-
| Maximum Time Travel restore operations | 10 restores per 10 minute (per database) |
16+
| Maximum Time Travel restore operations | 10 restores per 10 minutes (per database) |
1817
| Queries per Worker invocation (read [subrequest limits](/workers/platform/limits/#how-many-subrequests-can-i-make)) | 1000 (Workers Paid) / 50 (Free) |
1918
| Maximum number of columns per table | 100 |
2019
| Maximum number of rows per table | Unlimited (excluding per-database storage limits) |
@@ -32,22 +31,14 @@ Limits for individual queries (listed above) apply to each individual statement
3231
:::
3332

3433
[^1]: The maximum number of databases per account can be increased by request on Workers Paid and Enterprise plans, with support for millions to tens-of-millions of databases (or more) per account. Refer to the guidance on limit increases on this page to request an increase.
35-
[^2]: The maximum storage per account can be increased by request on Workers Paid and Enterprise plans. Refer to the guidance on limit increases on this page to request an increase.
36-
[^3]: A single Worker script can have up to 1 MB of script metadata. A binding is defined as a binding to a resource, such as a D1 database, KV namespace, [environmental variable](/workers/configuration/environment-variables/), or secret. Each resource binding is approximately 150-bytes, however environmental variables and secrets are controlled by the size of the value you provide. Excluding environmental variables, you can bind up to \~5,000 D1 databases to a single Worker script.
37-
[^4]: Requests to Cloudflare API must resolve in 30 seconds. Therefore, this duration limit also applies to the entire batch call.
38-
[^5]: The imported file is uploaded to R2. Refer to [R2 upload limit](/r2/platform/limits).
3934

40-
<Details header = "Footnotes" open={true}>
41-
1: The maximum number of databases per account can be increased by request on Workers Paid and Enterprise plans, with support for millions to tens-of-millions of databases (or more) per account. Refer to the guidance on limit increases on this page to request an increase.
42-
43-
2: The maximum storage per account can be increased by request on Workers Paid and Enterprise plans. Refer to the guidance on limit increases on this page to request an increase.
35+
[^2]: The maximum storage per account can be increased by request on Workers Paid and Enterprise plans. Refer to the guidance on limit increases on this page to request an increase.
4436

45-
3: A single Worker script can have up to 1 MB of script metadata. A binding is defined as a binding to a resource, such as a D1 database, KV namespace, [environmental variable](/workers/configuration/environment-variables/), or secret. Each resource binding is approximately 150 bytes, however environmental variables and secrets are controlled by the size of the value you provide. Excluding environmental variables, you can bind up to \~5,000 D1 databases to a single Worker script.
37+
[^3]: A single Worker script can have up to 1 MB of script metadata. A binding is defined as a binding to a resource, such as a D1 database, KV namespace, [environmental variable](/workers/configuration/environment-variables/), or secret. Each resource binding is approximately 150-bytes, however environmental variables and secrets are controlled by the size of the value you provide. Excluding environmental variables, you can bind up to \~5,000 D1 databases to a single Worker script.
4638

47-
4: Requests to Cloudflare API must resolve in 30 seconds. Therefore, this duration limit also applies to the entire batch call.
39+
[^4]: Requests to Cloudflare API must resolve in 30 seconds. Therefore, this duration limit also applies to the entire batch call.
4840

49-
5: The imported file is uploaded to R2. Refer to [R2 upload limit](/r2/platform/limits).
50-
</Details>
41+
[^5]: The imported file is uploaded to R2. Refer to [R2 upload limit](/r2/platform/limits).
5142

5243
Cloudflare also offers other storage solutions such as [Workers KV](/kv/api/), [Durable Objects](/durable-objects/), and [R2](/r2/get-started/). Each product has different advantages and limits. Refer to [Choose a data or storage product](/workers/platform/storage-options/) to review which storage option is right for your use case.
5344

@@ -57,4 +48,4 @@ Cloudflare also offers other storage solutions such as [Workers KV](/kv/api/), [
5748

5849
Frequently asked questions related to D1 limits:
5950

60-
<Render file="faq-limits" product="d1"/>
51+
<Render file="faq-limits" product="d1" />

src/content/docs/durable-objects/platform/limits.mdx

Lines changed: 25 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -5,42 +5,31 @@ sidebar:
55
order: 2
66
---
77

8-
import { Render, GlossaryTooltip, Details, WranglerConfig } from "~/components";
8+
import { Render, GlossaryTooltip, WranglerConfig } from "~/components";
99

1010
Durable Objects are a special kind of Worker, so [Workers Limits](/workers/platform/limits/) apply according to your Workers plan. In addition, Durable Objects have specific limits as listed in this page.
1111

1212
## SQLite-backed Durable Objects general limits
1313

14-
| Feature | Limit |
15-
| ------------------------------ | -------------------------------------------------------------------------------------------------------------- |
16-
| Number of Objects | Unlimited (within an account or of a given class) |
17-
| Maximum Durable Object classes | 500 (Workers Paid) / 100 (Free) [^1] |
18-
| Storage per account | Unlimited (Workers Paid) / 5GB (Free) [^2] |
19-
| Storage per class | Unlimited [^3] |
20-
| Storage per Durable Object | 10 GB [^3] |
21-
| Key size | Key and value combined cannot exceed 2 MB |
22-
| Value size | Key and value combined cannot exceed 2 MB |
23-
| WebSocket message size | 32 MiB (only for received messages) |
24-
| CPU per request | 30 seconds (default) / configurable to 5 minutes of [active CPU time](/workers/platform/limits/#cpu-time) [^4] |
14+
| Feature | Limit |
15+
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
16+
| Number of Objects | Unlimited (within an account or of a given class) |
17+
| Maximum Durable Object classes (per account) | 500 (Workers Paid) / 100 (Free) [^1] |
18+
| Storage per account | Unlimited (Workers Paid) / 5GB (Free) [^2] |
19+
| Storage per class | Unlimited [^3] |
20+
| Storage per Durable Object | 10 GB [^3] |
21+
| Key size | Key and value combined cannot exceed 2 MB |
22+
| Value size | Key and value combined cannot exceed 2 MB |
23+
| WebSocket message size | 32 MiB (only for received messages) |
24+
| CPU per request | 30 seconds (default) / configurable to 5 minutes of [active CPU time](/workers/platform/limits/#cpu-time) [^4] |
2525

2626
[^1]: Identical to the Workers [script limit](/workers/platform/limits/).
2727

2828
[^2]: Durable Objects both bills and measures storage based on a gigabyte <br/> (1 GB = 1,000,000,000 bytes) and not a gibibyte (GiB). <br/>
2929

3030
[^3]: Accounts on the Workers Free plan are limited to 5 GB total Durable Objects storage.
3131

32-
[^4]: Each incoming HTTP request or WebSocket _message_ resets the remaining available CPU time to 30 seconds. This allows the Durable Object to consume up to 30 seconds of compute after each incoming network request, with each new network request resetting the timer. If you consume more than 30 seconds of compute between incoming network requests, there is a heightened chance that the individual Durable Object is evicted and reset. CPU time per request invocation [can be increased](/durable-objects/platform/limits/#increasing-durable-object-cpu-limits).
33-
34-
<Details header="Footnotes" open={true}>
35-
1. Identical to the Workers [script limit](/workers/platform/limits/).
36-
37-
2. Durable Objects both bills and measures storage based on a gigabyte <br/> (1 GB = 1,000,000,000 bytes) and not a gibibyte (GiB). <br/>
38-
39-
3. Accounts on the Workers Free plan are limited to 5GB total Durable Objects storage.
40-
41-
4. Each incoming HTTP request or WebSocket _message_ resets the remaining available CPU time to 30 seconds. This allows the Durable Object to consume up to 30 seconds of compute after each incoming network request, with each new network request resetting the timer. If you consume more than 30 seconds of compute between incoming network requests, there is a heightened chance that the individual Durable Object is evicted and reset. CPU time per request invocation [can be increased](/durable-objects/platform/limits/#increasing-durable-object-cpu-limits).
42-
43-
</Details>
32+
[^4]: Each incoming HTTP request or WebSocket _message_ resets the remaining available CPU time to 30 seconds. This allows the Durable Object to consume up to 30 seconds of compute after each incoming network request, with each new network request resetting the timer. If you consume more than 30 seconds of compute between incoming network requests, there is a heightened chance that the individual Durable Object is evicted and reset. CPU time per request invocation [can be increased](/durable-objects/platform/limits/#can-i-increase-durable-objects-cpu-limit).
4433

4534
### SQL storage limits
4635

@@ -60,32 +49,23 @@ For Durable Object classes with [SQLite storage](/durable-objects/api/sqlite-sto
6049

6150
<Render file="do-plans-note" product="durable-objects" />
6251

63-
| Feature | Limit for class with key-value storage backend |
64-
| ------------------------------ | --------------------------------------------------- |
65-
| Number of Objects | Unlimited (within an account or of a given class) |
66-
| Maximum Durable Object classes | 500 (Workers Paid) / 100 (Free) [^5] |
67-
| Storage per account | 50 GB (can be raised by contacting Cloudflare) [^6] |
68-
| Storage per class | Unlimited |
69-
| Storage per Durable Object | Unlimited |
70-
| Key size | 2 KiB (2048 bytes) |
71-
| Value size | 128 KiB (131072 bytes) |
72-
| WebSocket message size | 32 MiB (only for received messages) |
73-
| CPU per request | 30s (including WebSocket messages) [^7] |
52+
| Feature | Limit for class with key-value storage backend |
53+
| -------------------------------------------- | --------------------------------------------------- |
54+
| Number of Objects | Unlimited (within an account or of a given class) |
55+
| Maximum Durable Object classes (per account) | 500 (Workers Paid) / 100 (Free) [^5] |
56+
| Storage per account | 50 GB (can be raised by contacting Cloudflare) [^6] |
57+
| Storage per class | Unlimited |
58+
| Storage per Durable Object | Unlimited |
59+
| Key size | 2 KiB (2048 bytes) |
60+
| Value size | 128 KiB (131072 bytes) |
61+
| WebSocket message size | 32 MiB (only for received messages) |
62+
| CPU per request | 30s (including WebSocket messages) [^7] |
7463

7564
[^5]: Identical to the Workers [script limit](/workers/platform/limits/).
7665

7766
[^6]: Durable Objects both bills and measures storage based on a gigabyte <br/> (1 GB = 1,000,000,000 bytes) and not a gibibyte (GiB). <br/>
7867

79-
[^7]: Each incoming HTTP request or WebSocket _message_ resets the remaining available CPU time to 30 seconds. This allows the Durable Object to consume up to 30 seconds of compute after each incoming network request, with each new network request resetting the timer. If you consume more than 30 seconds of compute between incoming network requests, there is a heightened chance that the individual Durable Object is evicted and reset. CPU time per request invocation [can be increased](/durable-objects/platform/limits/#increasing-durable-object-cpu-limits).
80-
81-
<Details header="Footnotes" open={true}>
82-
5. Identical to the Workers [script limit](/workers/platform/limits/).
83-
84-
6. Durable Objects both bills and measures storage based on a gigabyte <br/> (1 GB = 1,000,000,000 bytes) and not a gibibyte (GiB). <br/>
85-
86-
7. Each incoming HTTP request or WebSocket _message_ resets the remaining available CPU time to 30 seconds. This allows the Durable Object to consume up to 30 seconds of compute after each incoming network request, with each new network request resetting the timer. If you consume more than 30 seconds of compute between incoming network requests, there is a heightened chance that the individual Durable Object is evicted and reset. CPU time per request invocation [can be increased](/durable-objects/platform/limits/#increasing-durable-object-cpu-limits).
87-
88-
</Details>
68+
[^7]: Each incoming HTTP request or WebSocket _message_ resets the remaining available CPU time to 30 seconds. This allows the Durable Object to consume up to 30 seconds of compute after each incoming network request, with each new network request resetting the timer. If you consume more than 30 seconds of compute between incoming network requests, there is a heightened chance that the individual Durable Object is evicted and reset. CPU time per request invocation [can be increased](/durable-objects/platform/limits/#can-i-increase-durable-objects-cpu-limit).
8969

9070
<Render file="limits_increase" product="workers" />
9171

0 commit comments

Comments
 (0)