Skip to content

Clarify rate limit binding docs config#28117

Open
ask-bonk[bot] wants to merge 1 commit intoproductionfrom
opencode/issue25590-20260205213056
Open

Clarify rate limit binding docs config#28117
ask-bonk[bot] wants to merge 1 commit intoproductionfrom
opencode/issue25590-20260205213056

Conversation

@ask-bonk
Copy link
Contributor

@ask-bonk ask-bonk bot commented Feb 5, 2026

All linked pages exist. Here's a summary of the changes made to src/content/docs/workers/runtime-apis/bindings/rate-limit.mdx:

Changes made

  1. Replaced the Configuration section (lines 136-173) with a proper settings table that:

    • Makes clear that namespace_id is a string type containing a valid integer, and explicitly states "This is intentional"
    • Documents simple as an object and notes it is "the only supported type"
    • Documents simple.limit and simple.period with their types and constraints
  2. Added a :::note callout about namespace sharing (lines 147-151) that explains:

    • Bindings with the same namespace_id share rate limit counters, even across different Workers on the same account
    • This is intentional for cross-Worker rate limit enforcement
    • Users should use unique namespace_id values if they don't want sharing
  3. Added a new "Monitoring" section (lines 220-225) that explains:

    • Rate limiting bindings are not visible in the Cloudflare dashboard
    • Links to Workers Observability (Workers Logs and Traces) for observing 429 responses
    • Links to Workers Analytics Engine for emitting custom rate_limited events

Closes #25590

github run

Co-authored-by: elithrar <elithrar@users.noreply.github.com>
@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2026

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

Pattern Owners
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @cloudflare/wrangler, @mattietk

@elithrar elithrar enabled auto-merge (squash) February 6, 2026 12:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:workers Related to Workers product size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Worker ratelimits binding documentation is ambiguous

7 participants