Skip to content

Conversation

kathayl
Copy link
Contributor

@kathayl kathayl commented Oct 16, 2025

add new FAQ on 422s

Summary

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

add new FAQ on 422s
Copy link
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/browser-rendering/ @mchenco, @cloudflare/pcx-technical-writing, @celso, @danielgek, @kathayl, @ToriLindsay

Copy link
Contributor


### Why am I getting a `422 Unprocessable Entity` error?

A `422 Unprocessable Entity` error usually means that Browser Rendering wasn’t able to complete an action because of an issue with the site, not your request.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A `422 Unprocessable Entity` error usually means that Browser Rendering wasn’t able to complete an action because of an issue with the site, not your request.
Sometimes a `422 Unprocessable Entity` error is caused by the website you are crawling, and not by Browser Rendering or your request. For example, the website might have crashed, errored out, or consumed too much memory during rendering.```

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought the logic of this one could be a little clearer and more straightforward. Because you started off by saying that it's not the request (but the fault of the website they're crawling), but in that third bullet point, you're saying that it is a problem with the request.

I would recommend breaking it into the two scenarios (the website's fault vs. the request's fault) and then perhaps add a sentence under each that explains what they can do about it.


A `422 Unprocessable Entity` error usually means that Browser Rendering wasn’t able to complete an action because of an issue with the site, not your request.

This can happen if:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This can happen if:
However, it can also be caused by your request exceeding the [timeout limits](/browser-rendering/reference/timeouts/) for page load, element load, or an action. In this case, try [increasing the timeout limits](/browser-rendering/reference/timeouts/#notes-and-recommendations).

I added the step they can take - is this right?

A `422 Unprocessable Entity` error usually means that Browser Rendering wasn’t able to complete an action because of an issue with the site, not your request.

This can happen if:
- The website consumes too much memory during rendering.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The website consumes too much memory during rendering.


This can happen if:
- The website consumes too much memory during rendering.
- The page itself crashed or returned an error before the action completed.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The page itself crashed or returned an error before the action completed.

This can happen if:
- The website consumes too much memory during rendering.
- The page itself crashed or returned an error before the action completed.
- The request exceeded one of the [timeout limits](/browser-rendering/reference/timeouts/) for page load, element load, or an action.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The request exceeded one of the [timeout limits](/browser-rendering/reference/timeouts/) for page load, element load, or an action.

- The website consumes too much memory during rendering.
- The page itself crashed or returned an error before the action completed.
- The request exceeded one of the [timeout limits](/browser-rendering/reference/timeouts/) for page load, element load, or an action.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

- The page itself crashed or returned an error before the action completed.
- The request exceeded one of the [timeout limits](/browser-rendering/reference/timeouts/) for page load, element load, or an action.

Most often, this error is caused by a timeout. You can review the different timers and their limits in the [REST API timeouts reference](/browser-rendering/reference/timeouts/)).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Most often, this error is caused by a timeout. You can review the different timers and their limits in the [REST API timeouts reference](/browser-rendering/reference/timeouts/)).


To resolve: [Upgrade to a Workers Paid plan](/workers/platform/pricing/) which allows for more than 10 minutes of usage a day and has higher [limits](/browser-rendering/platform/limits/#workers-paid). If you recently upgraded but still see this error, try redeploying your Worker to ensure your usage is correctly associated with your new plan.

### Why am I getting a `422 Unprocessable Entity` error?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Why am I getting a `422 Unprocessable Entity` error?
### `422 Unprocessable Entity` error

You an ignore this for now if you want to save it for another time, but I thought it might be better to have all of these error-specific troubleshooting steps just have the name of the error as the header to avoid having a bunch of headers all phrased differently ("I see x error", "I'm getting x error", "what do I do?" "how do I fix" etc) and just keep it very clear and simple.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are two other headers in this doc that could also use this update.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants