From 62a881decab9c93c451d211c28a26bd93816606a Mon Sep 17 00:00:00 2001 From: ToriLindsay Date: Fri, 30 Jan 2026 16:25:32 +0000 Subject: [PATCH 1/4] [Browser Rendering] Clean up LImits doc --- src/content/docs/browser-rendering/limits.mdx | 49 +++++-------------- 1 file changed, 13 insertions(+), 36 deletions(-) diff --git a/src/content/docs/browser-rendering/limits.mdx b/src/content/docs/browser-rendering/limits.mdx index e31e57ffa52f314..6eebbd792a035e3 100644 --- a/src/content/docs/browser-rendering/limits.mdx +++ b/src/content/docs/browser-rendering/limits.mdx @@ -8,49 +8,26 @@ sidebar: import { Render, Plan, Tabs, TabItem, DashButton } from "~/components"; - +Browser Rendering limits are based on your [Cloudflare Workers plan](/workers/platform/pricing/): -## Workers Free +| Workers plan | Free | Paid | +| -------------------------------------------------------- | ------------------ | ----------------- | +| Usage | 10 minutes per day | No limit | +| Concurrent browsers [^1] (Workers Bindings only) | 3 per account | 10 per account included + $2.00 for each additional account [averaged monthly](/browser-rendering/pricing/#how-is-the-number-of-concurrent-browsers-calculated) | +| New browser instances (Workers Bindings only) | 3 per minute | 30 per minute | +| Total requests (REST API only) | 6 per minute | 180 per minute | -Users on the [Workers Free plan](/workers/platform/pricing/) are limited to **10 minutes of Browser Rendering usage per day**. +[^1]: Browsers close upon task completion or sixty seconds of inactivity (if you do not [extend your browser timeout](#browser-timeouts)), so many workflows do not require a high number of concurrent browsers. -To increase this limit, go to the **Compute (Workers) > Workers plans** page in the Cloudflare dashboard: +[More about Browser Rendering pricing](/browser-rendering/pricing/). +To upgrade from Workers Free to Workers Paid, go to the **Workers plans** page in the Cloudflare dashboard. -[Learn more about Workers Plans](/workers/platform/pricing). +If you are on a Workers Paid plan and you want to increase your limits beyond those listed here, Cloudflare will grant [requests for higher limits](https://forms.gle/CdueDKvb26mTaepa9) on a case-by-case basis. -| Feature | Limit | -| -------------------------------------------------------- | --------------- | -| Concurrent browsers per account (Workers Bindings only) | 3 per account | -| New browser instances per minute (Workers Bindings only) | 3 per minute | -| Browser timeout | 60 seconds [^1] | -| Total requests per min (REST API only) | 6 per minute | - -[^1]: By default, a browser will time out after 60 seconds of inactivity. You can extend this to up to 10 minutes using the [`keep_alive` option](/browser-rendering/puppeteer/#keep-alive). Call `browser.close()` to release the browser instance immediately. - -## Workers Paid - -:::note[Need higher limits?] -If you are on the Workers Free plan, [upgrade to Workers Paid](/workers/platform/pricing/) for higher limits. If you are already on Workers Paid and need limits beyond those listed below, Cloudflare will grant [requests for higher limits](https://forms.gle/CdueDKvb26mTaepa9) on a case-by-case basis. -::: - -| Feature | Limit | -| -------------------------------------------------------- | --------------- | -| Concurrent browsers per account (Workers Bindings only) | 30 per account | -| New browser instances per minute (Workers Bindings only) | 30 per minute | -| Browser timeout | 60 seconds [^1] | -| Total requests per min (REST API only) | 180 per minute | - -:::note[About concurrent browsers] -The Workers Paid plan includes 10 concurrent browsers at no additional cost. You can use up to 30 concurrent browsers per account, but usage beyond the included 10 browsers is billed at $2.00 per additional browser (averaged monthly). - -For full pricing details and billing examples, refer to [Pricing](/browser-rendering/pricing/). -::: - -### Note on concurrency - -While the limits above define the maximum number of concurrent browser sessions per account, in practice you may not need to hit these limits. Browser sessions close automatically—by default, after 60 seconds of inactivity or upon task completion—so if each session finishes its work before a new request comes in, the effective concurrency is lower. This means that most workflows do not require very high concurrent browser limits. +## Browser timeouts +Regardless of your plan, your browser will time out after sixty seconds if it is inactive. To keep your browser active, use the [`keep_alive` option](/browser-rendering/puppeteer/#keep-alive). When you want to close the browser instance, use `browser.close()`. ## Limits FAQ & troubleshooting From f753b2713df4bc7c1a8feab04cecd42fa574f054 Mon Sep 17 00:00:00 2001 From: ToriLindsay Date: Fri, 30 Jan 2026 16:37:19 +0000 Subject: [PATCH 2/4] Apply suggestion from @ToriLindsay --- src/content/docs/browser-rendering/limits.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/browser-rendering/limits.mdx b/src/content/docs/browser-rendering/limits.mdx index 6eebbd792a035e3..505e31ee4ea6153 100644 --- a/src/content/docs/browser-rendering/limits.mdx +++ b/src/content/docs/browser-rendering/limits.mdx @@ -12,7 +12,7 @@ Browser Rendering limits are based on your [Cloudflare Workers plan](/workers/pl | Workers plan | Free | Paid | | -------------------------------------------------------- | ------------------ | ----------------- | -| Usage | 10 minutes per day | No limit | +| Browser hours | 10 minutes per day | 10 hours per month + $0.09 for each additional hour | | Concurrent browsers [^1] (Workers Bindings only) | 3 per account | 10 per account included + $2.00 for each additional account [averaged monthly](/browser-rendering/pricing/#how-is-the-number-of-concurrent-browsers-calculated) | | New browser instances (Workers Bindings only) | 3 per minute | 30 per minute | | Total requests (REST API only) | 6 per minute | 180 per minute | From 9f020450391d353b16e7f195277498d99c5773ac Mon Sep 17 00:00:00 2001 From: ToriLindsay Date: Mon, 2 Feb 2026 13:24:40 +0000 Subject: [PATCH 3/4] Updated from PM feedback --- src/content/docs/browser-rendering/limits.mdx | 30 ++++++++++++------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/src/content/docs/browser-rendering/limits.mdx b/src/content/docs/browser-rendering/limits.mdx index 505e31ee4ea6153..f65d300e4ea8c0c 100644 --- a/src/content/docs/browser-rendering/limits.mdx +++ b/src/content/docs/browser-rendering/limits.mdx @@ -8,24 +8,32 @@ sidebar: import { Render, Plan, Tabs, TabItem, DashButton } from "~/components"; -Browser Rendering limits are based on your [Cloudflare Workers plan](/workers/platform/pricing/): +Browser Rendering limits are based on your [Cloudflare Workers plan](/workers/platform/pricing/). -| Workers plan | Free | Paid | -| -------------------------------------------------------- | ------------------ | ----------------- | -| Browser hours | 10 minutes per day | 10 hours per month + $0.09 for each additional hour | -| Concurrent browsers [^1] (Workers Bindings only) | 3 per account | 10 per account included + $2.00 for each additional account [averaged monthly](/browser-rendering/pricing/#how-is-the-number-of-concurrent-browsers-calculated) | -| New browser instances (Workers Bindings only) | 3 per minute | 30 per minute | -| Total requests (REST API only) | 6 per minute | 180 per minute | +For pricing information, refer to [Browser Rendering pricing](/browser-rendering/pricing/). -[^1]: Browsers close upon task completion or sixty seconds of inactivity (if you do not [extend your browser timeout](#browser-timeouts)), so many workflows do not require a high number of concurrent browsers. +## Workers Free -[More about Browser Rendering pricing](/browser-rendering/pricing/). +| Feature | Limit | +| -------------------------------------------------------- | --------------- | +| Browser hours | 10 minutes per day | +| Concurrent browsers per account [^1] (Workers Bindings only) | 3 per account | +| New browser instances (Workers Bindings only) | 3 per minute | +| Total requests (REST API only) | 6 per minute | -To upgrade from Workers Free to Workers Paid, go to the **Workers plans** page in the Cloudflare dashboard. - +## Workers Paid If you are on a Workers Paid plan and you want to increase your limits beyond those listed here, Cloudflare will grant [requests for higher limits](https://forms.gle/CdueDKvb26mTaepa9) on a case-by-case basis. +| Feature | Limit | +| -------------------------------------------------------- | --------------- | +| Browser hours | No limit ([See pricing](/workers/platform/pricing/)) | +| Concurrent browsers per account [^1] (Workers Bindings only) | 30 per account ([See pricing](/workers/platform/pricing/)) | +| New browser instances per minute (Workers Bindings only) | 30 per minute | +| Total requests per min (REST API only) | 180 per minute | + +[^1]: Browsers close upon task completion or sixty seconds of inactivity (if you do not [extend your browser timeout](#browser-timeouts)). Therefore, in practice, many workflows do not require a high number of concurrent browsers. + ## Browser timeouts Regardless of your plan, your browser will time out after sixty seconds if it is inactive. To keep your browser active, use the [`keep_alive` option](/browser-rendering/puppeteer/#keep-alive). When you want to close the browser instance, use `browser.close()`. From ba9783c7586dc0afcab55bbc1934f3f1348682bb Mon Sep 17 00:00:00 2001 From: ToriLindsay Date: Wed, 4 Feb 2026 12:43:05 +0000 Subject: [PATCH 4/4] Update from PM feedback --- src/content/docs/browser-rendering/limits.mdx | 20 +++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/src/content/docs/browser-rendering/limits.mdx b/src/content/docs/browser-rendering/limits.mdx index f65d300e4ea8c0c..11f8ca2cfafe752 100644 --- a/src/content/docs/browser-rendering/limits.mdx +++ b/src/content/docs/browser-rendering/limits.mdx @@ -14,28 +14,36 @@ For pricing information, refer to [Browser Rendering pricing](/browser-rendering ## Workers Free +:::note[Need higher limits?] +If you are on a Workers Free plan and you want to increase your limits, upgrade to a Workers Paid plan in the **Workers plans** page of the Cloudflare dashboard: + +::: + | Feature | Limit | | -------------------------------------------------------- | --------------- | | Browser hours | 10 minutes per day | -| Concurrent browsers per account [^1] (Workers Bindings only) | 3 per account | +| Concurrent browsers per account (Workers Bindings only) [^1] | 3 per account | | New browser instances (Workers Bindings only) | 3 per minute | +| Browser timeout | 60 seconds [^2] | | Total requests (REST API only) | 6 per minute | ## Workers Paid +:::note[Need higher limits?] If you are on a Workers Paid plan and you want to increase your limits beyond those listed here, Cloudflare will grant [requests for higher limits](https://forms.gle/CdueDKvb26mTaepa9) on a case-by-case basis. +::: | Feature | Limit | | -------------------------------------------------------- | --------------- | -| Browser hours | No limit ([See pricing](/workers/platform/pricing/)) | -| Concurrent browsers per account [^1] (Workers Bindings only) | 30 per account ([See pricing](/workers/platform/pricing/)) | +| Browser hours | No limit ([See pricing](/browser-rendering/pricing/)) | +| Concurrent browsers per account (Workers Bindings only) [^1] | 30 per account ([See pricing](/browser-rendering/pricing/)) | | New browser instances per minute (Workers Bindings only) | 30 per minute | +| Browser timeout | 60 seconds [^2] | | Total requests per min (REST API only) | 180 per minute | -[^1]: Browsers close upon task completion or sixty seconds of inactivity (if you do not [extend your browser timeout](#browser-timeouts)). Therefore, in practice, many workflows do not require a high number of concurrent browsers. +[^1]: Browsers close upon task completion or sixty seconds of inactivity (if you do not [extend your browser timeout](#can-i-increase-the-browser-timeout)). Therefore, in practice, many workflows do not require a high number of concurrent browsers. -## Browser timeouts -Regardless of your plan, your browser will time out after sixty seconds if it is inactive. To keep your browser active, use the [`keep_alive` option](/browser-rendering/puppeteer/#keep-alive). When you want to close the browser instance, use `browser.close()`. +[^2]: By default, a browser will time out after 60 seconds of inactivity. You can extend this to up to 10 minutes using the [`keep_alive` option](/browser-rendering/puppeteer/#keep-alive). Call `browser.close()` to release the browser instance immediately. ## Limits FAQ & troubleshooting