Limits

Users on the Workers Free plan are limited to 10 minutes of browser rendering usage per day.

To increase this limit, go to the Compute (Workers) > Workers plans page in the Cloudflare dashboard:

Learn more about Workers Plans.

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.

To upgrade, go to the Compute (Workers) > Workers plans page in the Cloudflare dashboard:

If you are hitting concurrency limits, or want to optimize concurrent browser usage with the Workers Binding method, here are a few tips:

• Optimize with tabs or shared browsers: Instead of launching a new browser for each task, consider opening multiple tabs or running multiple actions within the same browser instance.
• Reuse sessions: You can optimize your setup and decrease startup time by reusing sessions instead of launching a new browser every time. If you are concerned about maintaining test isolation (for example, for tests that depend on a clean environment), we recommend using incognito browser contexts ↗, which isolate cookies and cache with other sessions.

If you are still running into concurrency limits you can request a higher limit ↗.

By default, a browser instance will time out after 60 seconds of inactivity. If you want to keep the browser open longer, you can use the keep_alive option which allows you to extend the timeout to up to 10 minutes.

There is no fixed maximum lifetime for a browser session as long as it remains active. By default, Browser Rendering closes sessions after 1 minute of inactivity to prevent unintended usage. You can increase this inactivity timeout to up to 10 minutes.

If you need sessions to remain open longer, keep them active by sending a command at least once within your configured inactivity window (for example, every 10 minutes). Sessions also close when Browser Rendering rolls out a new release.

If you recently upgraded to the Workers Paid plan but still encounter the 10-minute per day limit, redeploy your Worker to ensure your usage is correctly associated with the new plan.

When you make too many requests in a short period of time, Browser Rendering will respond with HTTP status code 429 Too many requests. The response includes a Retry-After header, which specifies how many seconds to wait before retrying. You can view your account's rate limits on the Limits page.

The example below demonstrates how to handle rate limiting gracefully by reading the Retry-After value and retrying the request after that delay.

const response = await fetch('https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/content', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer <your-token>',
    },
    body: JSON.stringify({ url: 'https://example.com' })
});

if (response.status === 429) {
    const retryAfter = response.headers.get('Retry-After');
    console.log(`Rate limited. Waiting ${retryAfter} seconds...`);
    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));

    // Retry the request
    const retryResponse = await fetch(/* same request as above */);
}

import puppeteer from "@cloudflare/puppeteer";

try {
  const browser = await puppeteer.launch(env.MYBROWSER);

  const page = await browser.newPage();
  await page.goto("https://example.com");
  const content = await page.content();

  await browser.close();
} catch (error) {
  if (error.status === 429) {
    const retryAfter = error.headers.get("Retry-After");
    console.log(
      `Browser instance limit reached. Waiting ${retryAfter} seconds...`,
    );
    await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));

    // Retry launching browser
    const browser = await puppeteer.launch(env.MYBROWSER);
  }
}

This Error processing the request: Unable to create new browser: code: 429: message: Browser time limit exceeded for today indicates you have hit the daily browser limit on the Workers Free plan. Workers Free plan accounts are limited to 10 minutes of browser rendering usage per day. If you exceed that limit, you will receive a 429 error until the next UTC day.

You can increase your limits by upgrading to a Workers Paid plan on the Workers plans page of the Cloudflare dashboard:

If you recently upgraded but still encounter the 10-minute per day limit, redeploy your Worker to ensure your usage is correctly associated with the new plan.