diff --git a/_includes/developer_guide/react_native/push_notifications.md b/_includes/developer_guide/react_native/push_notifications.md
index 5e6781269fc..665e1f5ad3e 100644
--- a/_includes/developer_guide/react_native/push_notifications.md
+++ b/_includes/developer_guide/react_native/push_notifications.md
@@ -140,6 +140,13 @@ To enable Braze to handle deep links inside React components when a push notific
 
 To learn more about what deep links are, see our [FAQ article]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/deep_linking_to_in-app_content/#what-is-deep-linking).
 
+{% 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](#step-3-1)) is implemented and still called on app launch.
+- Any native delegate or listener methods you use to handle push click events are still registered and invoked as expected.
+{% endalert %}
+
 {% tabs local %}
 {% tab Android Native %}
 If you're using the [Braze Expo plugin]({{site.baseurl}}/developer_guide/platforms/react_native/sdk_integration/?tab=expo#step-2-choose-a-setup-option), you can handle push notification deep links automatically by setting `androidHandlePushDeepLinksAutomatically` to `true` in your `app.json`.
@@ -148,7 +155,7 @@ To handle deep links manually instead, refer to the native Android documentation
 
 {% endtab %}
 {% tab iOS Native %}
-#### Step 3.1: Store the push notification payload on app launch
+#### Step 3.1: Store the push notification payload on app launch {#step-3-1}
 {% alert note %}
 Skip step 3.1 if you're using the Braze Expo plugin, as this is functionality is handled automatically.
 {% endalert %}
@@ -475,3 +482,14 @@ For iOS integrations, you can also reference our [push notification setup tutori
 If your device token won't register with Braze, first review [Push notifications stopped working](#troubleshooting-stopped-working).
 
 If your issue persists, there may be a separate dependency interfering with your Braze push notification configuration. You can try removing it or manually call `Braze.registerPushToken` instead.
+
+#### Deep links from push notifications don't open {#troubleshooting-deep-links}
+
+If deep links from push notifications stop opening after a migration, check the following:
+
+1. Verify your [React Native Linking](https://reactnative.dev/docs/linking) setup is still valid in your upgraded app.
+2. For iOS native integrations, confirm you implemented `populateInitialPayloadFromLaunchOptions` and `Braze.getInitialPushPayload` so that, when the app is launched from a terminated state, it can retrieve the initial push payload and pass its `url` into your deep link handler.
+3. If you're using the Braze Expo plugin, verify `androidHandlePushDeepLinksAutomatically` is set correctly for your implementation.
+4. Review recently added dependencies for overrides to notification handling or app delegate behavior.
+
+If you've completed these checks and the issue persists, [open a support ticket]({{site.baseurl}}/user_guide/administrative/access_braze/support/) and include SDK logs plus reproduction steps.