Cloudflare Worker bot prerender routing
RenderShield on Cloudflare Workers keeps browser delivery unchanged while adding deterministic crawler HTML for selected routes.
Delivery model
- Humans: normal SPA response path
- Bots: prerendered static HTML path
- Visibility:
x-rendershieldresponse header on both paths
Observed header values:
x-rendershield: bot-hitfor routed bot trafficx-rendershield: pass-throughfor normal browser traffic
Worker route base setup
Configure rewrite bases for the routes you want bots to receive as static HTML:
/docs/prerender/blog
This keeps crawler scope narrow and auditable.
Minimal deploy sequence
npx rendershield init
npx rendershield build
rendershield verify --prod https://yoursite.com/prerender/cloudflare
Then deploy the generated Worker and static assets to Cloudflare.