[s1gr1d]

DESCRIBE YOUR PR

Documents the tunnel changes in SDK 11.9.0.

⚠️ Merge this PR only after 10.77.1 and 11.9.0 are released.

• Next.js tunnelRoute: add handler mode (app/sentry-tunnel/route.ts). In this mode, a route handler in the app forwards only the request body to Sentry. Rewrite mode now sends with credentials: "omit". Apps behind Vercel Deployment Protection or another login should use handler mode.
• Troubleshooting: list what a custom tunnel must do, add handleTunnelRequest, and add a new "Credentials on Tunnel Requests" entry.
• Short notes in options.mdx, the getting-started includes, the Next.js setup pages, and TanStack Start.

Related SDK PRs, all going to be released in 11.9.0:

• feat(nextjs): Add a tunnel route handler that sends only the event payload to Sentry sentry-javascript#25456
• feat(core): Limit the body size of tunnel requests sentry-javascript#25515
• feat(nextjs): Send tunnel route requests with credentials: 'omit' sentry-javascript#25509

Backport PRs for 10.77.1:

• feat(v10/nextjs): Add a tunnel route handler that sends only the event payload to Sentry sentry-javascript#25559
• feat(v10/core): Limit the body size of tunnel requests sentry-javascript#25560
• feat(v10/nextjs): Send tunnel route requests with credentials: 'omit' sentry-javascript#25561

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

• Urgent deadline (GA date, etc.): YYYY-MM-DD
• Other deadline: with the 11.9.0 release
• No deadline: Not urgent, can wait up to 1 week+

SLA

• Teamwork makes the dream work, so please add a reviewer to your PRs.
• Please give the docs team up to 1 week to review your PR unless you've supplied a deadline.

Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs (subject matter experts)
• PR was reviewed and approved by a member of the Sentry docs team

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
develop-docs	Ready	Preview	Oct 27, 2026 12:47pm UTC
sentry-docs	Ready	Preview	Oct 27, 2026 12:47pm UTC

[cursor]

The plan checks page loads of the edited tunnel docs, client errors on those pages, and JavaScript docs 404s. An issue escalates when client errors rise or JavaScript 404s rise.

Monitoring in production

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

Readers of the Next.js build-options page now see tunnel handler mode for SDK 10.77.1 and 11.9.0. Those pages tell apps behind a login to use handler mode and to omit credentials in rewrite mode.

sentry-docs must deploy before this copy is live. The Vercel production project sentry-docs maps to that service in the deploy report workflow. This merge dropped the React getting-started tunnel edit.

Risk

A render fault in the shared troubleshooting MDX can break every JavaScript troubleshooting page. A combined AvailableSince version string can fail to render on the build-options page. A new middleware Expandable or new code samples can throw in the browser. A bad new link can send readers to a 404.

Intended effect

Connected telemetry cannot show that the new copy is live. No metric increments when handler mode or handleTunnelRequest appears on the page. absent means the live pages still omit handler mode, the 10.77.1 and 11.9.0 notes, or Credentials on Tunnel Requests after deploy. That HTML check is not in Sentry. See Not observable.

Page loads of the edited paths only show that the pages still open. They do not prove the new copy.

Regression watch

Watch client errors on the edited tunnel pages, JavaScript 404s, and page-load volume on those paths. Pageload failure rate on the unhashed JavaScript troubleshooting URL is the availability signal. The shared troubleshooting MDX is the widest blast radius.

Client errors on these URLs were zero in both windows. Treat any new title on these URLs as a regression. Pageload failure rate on the #using-the-tunnel-option hash was 53.8% over 48h and 0 in the last 24h. Do not treat that prior burst as this deploy.

Signal	Baseline	Window	Source	Rule
Client errors on tunnel docs URLs as a share of docs.page.load	0 errors and 90 page loads, 0%. 48h: 0 errors and 146 page loads, 0%	2026-10-26T12:45:00Z to 2026-10-27T12:45:00Z and 2026-10-25T12:45:00Z to 2026-10-27T12:45:00Z	Sentry org sentry project docs. Errors: environment:production (http.url:*platforms/javascript/guides/nextjs/configuration/build* OR http.url:*platforms/javascript/troubleshooting* OR http.url:*platforms/javascript/guides/nextjs/manual-setup*). Page loads: environment:production path:[/platforms/javascript/guides/nextjs/configuration/build/,/platforms/javascript/troubleshooting/,/platforms/javascript/guides/nextjs/manual-setup/] sum of docs.page.load	Hold the 24h error share at 0. Escalate when any error event appears on these URLs
docs.page.not_found for platforms/javascript	23 events in 24h. 26 events in the prior 24h	2026-10-26T12:45:00Z to 2026-10-27T12:45:00Z and 2026-10-25T12:45:00Z to 2026-10-26T12:45:00Z	Sentry org sentry project docs. environment:production requested_path:platforms/javascript sum of docs.page.not_found	Hold in 23-26 events per 24h. Escalate when the count rises above 26
Combined docs.page.load on the edited tunnel paths	217 loads in 24h. 148 loads in the prior 24h	2026-10-26T12:45:00Z to 2026-10-27T12:45:00Z and 2026-10-25T12:45:00Z to 2026-10-26T12:45:00Z	Sentry org sentry project docs. environment:production path:[/platforms/javascript/guides/nextjs/,/platforms/javascript/guides/nextjs/manual-setup/,/platforms/javascript/guides/nextjs/configuration/build/,/platforms/javascript/troubleshooting/,/platforms/javascript/guides/nextjs/troubleshooting/] sum of docs.page.load	Hold in 148-217 loads per 24h. Escalate when volume falls below 148
Pageload failure rate on the unhashed JavaScript troubleshooting URL	0 failures in 3 sampled pageloads in 24h. 0 failures in 10 sampled pageloads in 48h	2026-10-26T12:45:00Z to 2026-10-27T12:45:00Z and 2026-10-25T12:45:00Z to 2026-10-27T12:45:00Z	Sentry org sentry project docs. span.op:pageload environment:production url.full:https://docs.sentry.io/platforms/javascript/troubleshooting/ failure_rate()	Hold failure rate at 0. Escalate when failure rate rises above 0

If client errors rise, inspect Expandable, AvailableSince, code tabs, and MDX render on the Next.js build-options and JavaScript troubleshooting pages.

Not observable

Live HTML of the edited pages. Sentry does not store page body text. The executor cannot confirm handler mode, the 10.77.1 and 11.9.0 notes, handleTunnelRequest, or Credentials on Tunnel Requests from telemetry. Server 5xx sliced by docs path. Pageload spans use transaction /:path*?. Soft-navigation web vitals are not in this baseline.

Get Slack DMs about this change: cursor.com/automations/rollouts

[github-actions]

Please update the IS YOUR CHANGE URGENT? section of the PR description:

• Select exactly one option.
• If you selected an urgent or other deadline, provide the date as YYYY-MM-DD.

This information helps the Docs team prioritize your review.