Skip to content

[Challenges / Rules] Add back CAPTCHA_BOX #24316

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Aug 11, 2025
Merged

[Challenges / Rules] Add back CAPTCHA_BOX #24316

Changes from 3 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
23109a5
footnote
patriciasantaana Aug 11, 2025
16cfcf2
wording
patriciasantaana Aug 11, 2025
c754248
footnote fix
patriciasantaana Aug 11, 2025
af018e6
revert
patriciasantaana Aug 11, 2025
143fa28
remove footnote
patriciasantaana Aug 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions src/content/docs/rules/custom-errors/reference/error-tokens.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,14 @@ To display a custom page for each error, create a separate page per error. For e

The following custom error tokens are required by their respective error pages:

| Token | Required for |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `::CF_WIDGET_BOX::` | Interactive Challenge <br/>Country Challenge (Managed Challenge)<br/>Managed Challenge / I'm Under Attack Mode (Interstitial Page) |
| `::IM_UNDER_ATTACK_BOX::` | JS Challenge |
| `::CLOUDFLARE_ERROR_500S_BOX::` | 5XX Errors |
| `::CLOUDFLARE_ERROR_1000S_BOX::` | 1XXX Errors |
| Token | Required for |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `::CF_WIDGET_BOX::` <br /> `::CAPTCHA_BOX::`[^1] | Interactive Challenge <br/>Country Challenge (Managed Challenge)<br/>Managed Challenge / I'm Under Attack Mode (Interstitial Page) |
| `::IM_UNDER_ATTACK_BOX::` | JS Challenge |
| `::CLOUDFLARE_ERROR_500S_BOX::` | 5XX Errors |
| `::CLOUDFLARE_ERROR_1000S_BOX::` | 1XXX Errors |

[^1]: Not used for I'm Under Attack Mode.

Each custom error token has a default look and feel. However, you can use CSS to stylize each custom error tag using each tag's class ID. All the external resources like images, CSS, and scripts will be inlined during the process. As such, all external resources need to be available (that is, they must return `200 OK`) otherwise an error will be thrown.

Expand Down
Loading