Skip to content

Conversation

@patriciasantaana
Copy link
Contributor

@patriciasantaana patriciasantaana commented Aug 11, 2025

Summary

Adds back default ::CAPTCHA_BOX:: token to Rules error tokens

Documentation checklist

@github-actions
Copy link
Contributor

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

Pattern Owners
/src/content/docs/rules/ @pedrosousa, @cloudflare/pcx-technical-writing

@patriciasantaana
Copy link
Contributor Author

@migueldemoura can you take a look?

@github-actions
Copy link
Contributor

github-actions bot commented Aug 11, 2025

@patriciasantaana patriciasantaana marked this pull request as ready for review August 11, 2025 17:53
@patriciasantaana patriciasantaana requested review from a team and pedrosousa as code owners August 11, 2025 17:53
@patriciasantaana patriciasantaana enabled auto-merge (squash) August 11, 2025 17:55
@stepbrobd
Copy link

On the user side (my enterprise zone is sponsored by Cloudflare Project Alexandria so I'm happy to help out 🫡), ::CF_WIDGET_BOX:: is basically a catch all. I'm using it for non-interactive error pages (500 class errors, 1000 class errors, and Rate limiting block), and interactive error pages (IP/Country challenge, Managed challenge / I'm Under Attack Mode)

Even though in #23258 (comment), the error indicates that ::CAPTCHA_BOX:: is required, I was still able to successfully set the custom error page with only ::CF_WIDGET_BOX:: in the template

My speculation here is that ::CAPTCHA_BOX:: was indeed deprecated in the backend, but the error message returned was not changed along with the deprecation

@patriciasantaana patriciasantaana merged commit 61e6ff7 into production Aug 11, 2025
8 checks passed
@patriciasantaana patriciasantaana deleted the patricia/pcx18773-captcha-box branch August 11, 2025 18:12
@patriciasantaana
Copy link
Contributor Author

On the user side (my enterprise zone is sponsored by Cloudflare Project Alexandria so I'm happy to help out 🫡), ::CF_WIDGET_BOX:: is basically a catch all. I'm using it for non-interactive error pages (500 class errors, 1000 class errors, and Rate limiting block), and interactive error pages (IP/Country challenge, Managed challenge / I'm Under Attack Mode)

Even though in #23258 (comment), the error indicates that ::CAPTCHA_BOX:: is required, I was still able to successfully set the custom error page with only ::CF_WIDGET_BOX:: in the template

My speculation here is that ::CAPTCHA_BOX:: was indeed deprecated in the backend, but the error message returned was not changed along with the deprecation

@stepbrobd thank you for letting us know! Let me flag this over to the team to get it fixed on the Cloudflare dashboard 🙂

thomasgauvin pushed a commit that referenced this pull request Aug 15, 2025
* footnote

* wording

* footnote fix

* revert

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

Labels

product:rules Related to rules size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants