[BD-4660] Update push notifications to include more guidance on deep links for React Native by zairro · Pull Request #12403 · braze-inc/braze-docs

zairro · 2026-03-02T19:33:36Z

Why are you making this change? (required)

The content introduced by this PR provides users with additional guidance on deep links for React Native. It also includes guidance on how to reach out to support if issues persist.

Related PRs, issues, or features (optional)

BD-4660

Feature release date (optional)

N/A

Contributor checklist

I confirm that my PR meets the following:
- I signed the Contribution License Agreement (CLA).
- My style and voice follow the Braze Style Guide.
- My content contains correct spelling and grammar.
- All links are working correctly.
- If I renamed or moved a file or directory, I set up URL redirects for each file.
- If I updated or replaced an image, I did not remove the original image file from the repository. (For more information, see Updating an image).
- If my PR is related to a paid SKU, third party, SMS, AI, or privacy, I have received written approval from Braze Legal.

Submitting for review

If your PR meets the above requirements, select Ready for review, then add a reviewer:

Non-Braze contributors: Tag @braze-inc/docs-team in a comment below.
Braze employees: Have any relevant subject matter experts (like engineers or product managers) review your work first, then add the tech writer assigned to your specific vertical. If you're not sure which tech writer to add, you can add braze-inc/docs-team instead.

Thanks for contributing! We look forward to reading your work.

…React Native

Copilot

Pull request overview

Adds migration-focused guidance to the React Native push notifications docs to help readers troubleshoot deep link handling after upgrades.

Changes:

Adds an Important alert calling out deep link validation after upgrading/migrating React Native push dependencies.
Adds a new troubleshooting section for cases where push-notification deep links stop opening, including iOS closed-state handling pointers and support escalation guidance.

_includes/developer_guide/react_native/push_notifications.md

Co-authored-by: Copilot <[email protected]>

christorbraze

lgtm, but you'll want to get a review from the SDKs team for accuracy

atom-evens

approved, with a few minor edits

atom-evens · 2026-03-06T19:52:47Z

_includes/developer_guide/react_native/push_notifications.md


+{% alert important %}
+If you're migrating an existing React Native push integration, re-test deep linking after you upgrade the Braze SDK, React Native, Expo, or related libraries. Confirm that:
+- React Native [Linking](https://reactnative.dev/docs/linking) is still configured and handling your deep link URLs.


Suggested change

- React Native [Linking](https://reactnative.dev/docs/linking) is still configured and handling your deep link URLs.

- [React Native Linking](https://reactnative.dev/docs/linking) is still configured and handling your deep link URLs.

atom-evens · 2026-03-06T19:56:20Z

_includes/developer_guide/react_native/push_notifications.md


 {% endtab %}
 {% tab iOS Native %}
 #### Step 3.1: Store the push notification payload on app launch


Suggested change

#### Step 3.1: Store the push notification payload on app launch {#step-3-1}

atom-evens · 2026-03-06T19:56:48Z

_includes/developer_guide/react_native/push_notifications.md

+{% alert important %}
+If you're migrating an existing React Native push integration, re-test deep linking after you upgrade the Braze SDK, React Native, Expo, or related libraries. Confirm that:
+- React Native [Linking](https://reactnative.dev/docs/linking) is still configured and handling your deep link URLs.
+- Your iOS initial push payload handling (see **Step 3.1: Store the push notification payload on app launch**) is implemented and still called on app launch.


Suggested change

- Your iOS initial push payload handling (see **Step 3.1: Store the push notification payload on app launch**) is implemented and still called on app launch.

- Your iOS initial push payload handling (see [Step 3.1: Store the push notification payload on app launch](#step-3-1)) is implemented and still called on app launch.

hokstuff

LGTM after existing suggestions

Update push notifications to include more guidance on deep links for …

f3946af

…React Native

Copilot AI review requested due to automatic review settings March 2, 2026 19:33

zairro changed the title ~~Update push notifications to include more guidance on deep links for React Native~~ [BD-4660] Update push notifications to include more guidance on deep links for React Native Mar 2, 2026

Copilot started reviewing on behalf of zairro March 2, 2026 19:34 View session

zairro requested a review from a team March 2, 2026 19:35

Copilot AI reviewed Mar 2, 2026

View reviewed changes

_includes/developer_guide/react_native/push_notifications.md Outdated Show resolved Hide resolved

_includes/developer_guide/react_native/push_notifications.md Outdated Show resolved Hide resolved

zairro and others added 2 commits March 2, 2026 11:54

Update _includes/developer_guide/react_native/push_notifications.md

bbab3c3

Co-authored-by: Copilot <[email protected]>

Update _includes/developer_guide/react_native/push_notifications.md

59b42e4

Co-authored-by: Copilot <[email protected]>

vercel bot deployed to Preview – braze-docs-en March 2, 2026 19:58 View deployment

christorbraze reviewed Mar 3, 2026

View reviewed changes

atom-evens assigned zairro Mar 5, 2026

atom-evens requested a review from a team March 5, 2026 21:39

radixdev approved these changes Mar 6, 2026

View reviewed changes

zairro requested a review from a team March 6, 2026 19:43

zairro added the In Review label Mar 6, 2026

zairro mentioned this pull request Mar 6, 2026

[BD-4660](SF) Add troubleshooting for deep links in wrapper SDKs (React Native, Flutter, Cordova) #12226

Closed

atom-evens requested review from atom-evens and removed request for a team March 6, 2026 19:52

atom-evens approved these changes Mar 6, 2026

View reviewed changes

hokstuff approved these changes Mar 6, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[BD-4660] Update push notifications to include more guidance on deep links for React Native#12403

[BD-4660] Update push notifications to include more guidance on deep links for React Native#12403
zairro wants to merge 3 commits intodevelopfrom
zrko-react-native-deeplinks

zairro commented Mar 2, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

christorbraze left a comment

Uh oh!

atom-evens left a comment

Uh oh!

atom-evens Mar 6, 2026

Uh oh!

atom-evens Mar 6, 2026

Uh oh!

atom-evens Mar 6, 2026

Uh oh!

hokstuff left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

	- React Native [Linking](https://reactnative.dev/docs/linking) is still configured and handling your deep link URLs.
	- [React Native Linking](https://reactnative.dev/docs/linking) is still configured and handling your deep link URLs.


	#### Step 3.1: Store the push notification payload on app launch {#step-3-1}

	- Your iOS initial push payload handling (see Step 3.1: Store the push notification payload on app launch) is implemented and still called on app launch.
	- Your iOS initial push payload handling (see [Step 3.1: Store the push notification payload on app launch](#step-3-1)) is implemented and still called on app launch.

Conversation

zairro commented Mar 2, 2026

Why are you making this change? (required)

Related PRs, issues, or features (optional)

Feature release date (optional)

Contributor checklist

Submitting for review

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

christorbraze left a comment

Choose a reason for hiding this comment

Uh oh!

atom-evens left a comment

Choose a reason for hiding this comment

Uh oh!

atom-evens Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

atom-evens Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

atom-evens Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

hokstuff left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants