Skip to content

docs(react-native): Document native default for web Replay and Feedback exclusion - #20874

Open
huextrat wants to merge 1 commit into
getsentry:masterfrom
huextrat:react-native/metro-web-packages-native-default
Open

huextrat wants to merge 1 commit into
getsentry:masterfrom
huextrat:react-native/metro-web-packages-native-default

Conversation

@huextrat

@huextrat huextrat commented Nov 18, 2026 •

Copy link
Copy Markdown

DESCRIBE YOUR PR

Updates the "Reduce Bundle Size" section of the React Native Metro plugin page for getsentry/sentry-react-native#7062.

With that SDK change, includeWebReplay and includeWebFeedback no longer default to true. When they're not set, the Metro plugin removes web Session Replay and User Feedback from Android and iOS bundles and keeps them in web bundles. The current page tells native-only apps to set both options to false, which won't be needed anymore.

Changes:

  • Explain that native bundles exclude these packages by default, starting with the SDK version that ships the fix.
  • Replace the Default: true table with a table of the three values (not set, true, false) and their effect on native and web bundles.
  • Keep the false example for apps that also want to remove the packages from web bundles, and for older SDK versions.
  • Clarify that includeWebFeedback doesn't affect the React Native feedback widget.

getsentry/sentry-react-native#7062 is merged and listed under "Unreleased" in the SDK changelog. The page says "8.37.0": releases from main bump the minor version, so the next release after 8.36.0 should be 8.37.0. Please update the version if the fix ships in another one, and ideally merge once it is released.

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: YYYY-MM-DD
  • 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

LEGAL BOILERPLATE

Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.

EXTRA RESOURCES

🤖 Generated with Claude Code

…ck exclusion

Starting with the SDK version that ships getsentry/sentry-react-native#7062,
the Metro plugin removes web Session Replay and User Feedback from Android
and iOS bundles by default. Describe the three option values and keep the
`false` example for web bundles and older SDK versions.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@vercel

vercel Bot commented Nov 18, 2026

Copy link
Copy Markdown

@huextrat is attempting to deploy a commit to the Sentry Team on Vercel.

A member of the Team first needs to authorize it.

@codeowner-assignment
codeowner-assignment Bot requested review from a team, alwx and antonis and removed request for a team November 18, 2026 10:37
@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Nov 18, 2026
@huextrat
huextrat marked this pull request as ready for review November 19, 2026 08:24
@codeowner-assignment
codeowner-assignment Bot requested review from a team November 19, 2026 08:25
@cursor

cursor Bot commented Nov 19, 2026

Copy link
Copy Markdown
Contributor

Getting ready to monitor this change · Rollout details

Status Service Environment
⏳ Getting ready to monitor this change

### Reduce Bundle Size

If you're not targeting React Native for Web, you can exclude web-only packages like Session Replay and User Feedback from the bundle by opting out via the Metro Plugin options. When set to `false`, the Sentry Metro Plugin resolves the matching Sentry sub-packages to an empty module so they're not included in the output bundle.
Session Replay and User Feedback for the web are only used by React Native for Web. Starting with SDK version 8.37.0, the Sentry Metro Plugin removes these packages from Android and iOS bundles by default, so you don't need to configure anything. Web bundles keep them.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

8.37.0 isn't released yet, is this meant to be merged after a future release?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, this should be merged once 8.37.0 is out. The SDK change landed in getsentry/sentry-react-native#7062 (already merged), so it’ll ship in the next release. Happy to convert this to a draft or ping you when it’s released, whichever fits your docs process best.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants