From adcde53903fe07d8a6dfe6bace8a42503e928b68 Mon Sep 17 00:00:00 2001 From: Bartek Krason Date: Wed, 13 May 2026 17:13:32 +0200 Subject: [PATCH 1/3] docs: add deferred deep linking section --- versioned_docs/version-5.x/deep-linking.md | 12 ++++++++++++ versioned_docs/version-6.x/deep-linking.md | 12 ++++++++++++ versioned_docs/version-7.x/deep-linking.md | 12 ++++++++++++ versioned_docs/version-8.x/deep-linking.md | 12 ++++++++++++ 4 files changed, 48 insertions(+) diff --git a/versioned_docs/version-5.x/deep-linking.md b/versioned_docs/version-5.x/deep-linking.md index bbc447119a..12dd4974fd 100755 --- a/versioned_docs/version-5.x/deep-linking.md +++ b/versioned_docs/version-5.x/deep-linking.md @@ -353,3 +353,15 @@ const linking = { ``` Similar to the above example, you can integrate any API that provides a way to get the initial URL and to subscribe to new incoming URLs using the `getInitialURL` and `subscribe` options. + +## What if the app is not installed? + +Standard deep links (Universal Links or App Links) only work if the app is already installed on the user's device. If a user clicks a link but doesn't have your app, they are redirected to the Store. Once they install and open the app for the first time, the original link context and its parameters (like a referral code or a specific product ID) are usually lost. + +To solve this, you need **Deferred Deep Linking**. This technique allows the link parameters to "survive" the installation process so you can route the user to the correct screen on their very first launch. + +React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: + +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. +- [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. diff --git a/versioned_docs/version-6.x/deep-linking.md b/versioned_docs/version-6.x/deep-linking.md index e112f3f7f8..5f9e254575 100755 --- a/versioned_docs/version-6.x/deep-linking.md +++ b/versioned_docs/version-6.x/deep-linking.md @@ -318,3 +318,15 @@ const linking = { ``` Similar to the above example, you can integrate any API that provides a way to get the initial URL and to subscribe to new incoming URLs using the `getInitialURL` and `subscribe` options. + +## What if the app is not installed? + +Standard deep links (Universal Links or App Links) only work if the app is already installed on the user's device. If a user clicks a link but doesn't have your app, they are redirected to the Store. Once they install and open the app for the first time, the original link context and its parameters (like a referral code or a specific product ID) are usually lost. + +To solve this, you need **Deferred Deep Linking**. This technique allows the link parameters to "survive" the installation process so you can route the user to the correct screen on their very first launch. + +React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: + +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. +- [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. diff --git a/versioned_docs/version-7.x/deep-linking.md b/versioned_docs/version-7.x/deep-linking.md index cc62cb459f..208c9701c5 100755 --- a/versioned_docs/version-7.x/deep-linking.md +++ b/versioned_docs/version-7.x/deep-linking.md @@ -517,3 +517,15 @@ const linking = { Similar to the above example, you can integrate any API that provides a way to get the initial URL and to subscribe to new incoming URLs using the `getInitialURL` and `subscribe` options. + +## What if the app is not installed? + +Standard deep links (Universal Links or App Links) only work if the app is already installed on the user's device. If a user clicks a link but doesn't have your app, they are redirected to the Store. Once they install and open the app for the first time, the original link context and its parameters (like a referral code or a specific product ID) are usually lost. + +To solve this, you need **Deferred Deep Linking**. This technique allows the link parameters to "survive" the installation process so you can route the user to the correct screen on their very first launch. + +React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: + +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. +- [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. diff --git a/versioned_docs/version-8.x/deep-linking.md b/versioned_docs/version-8.x/deep-linking.md index 400cd3cba2..aea86cf4f0 100755 --- a/versioned_docs/version-8.x/deep-linking.md +++ b/versioned_docs/version-8.x/deep-linking.md @@ -469,3 +469,15 @@ const linking = { Similar to the above example, you can integrate any API that provides a way to get the initial URL and to subscribe to new incoming URLs using the `getInitialURL` and `subscribe` options. + +## What if the app is not installed? + +Standard deep links (Universal Links or App Links) only work if the app is already installed on the user's device. If a user clicks a link but doesn't have your app, they are redirected to the Store. Once they install and open the app for the first time, the original link context and its parameters (like a referral code or a specific product ID) are usually lost. + +To solve this, you need **Deferred Deep Linking**. This technique allows the link parameters to "survive" the installation process so you can route the user to the correct screen on their very first launch. + +React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: + +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. +- [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. From 74515ef88916bafa8807680f9f09e381777bfbd1 Mon Sep 17 00:00:00 2001 From: Bartek Krason Date: Wed, 13 May 2026 17:17:03 +0200 Subject: [PATCH 2/3] docs: add swm link --- versioned_docs/version-5.x/deep-linking.md | 2 +- versioned_docs/version-6.x/deep-linking.md | 2 +- versioned_docs/version-7.x/deep-linking.md | 2 +- versioned_docs/version-8.x/deep-linking.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/versioned_docs/version-5.x/deep-linking.md b/versioned_docs/version-5.x/deep-linking.md index 12dd4974fd..b520f3bd00 100755 --- a/versioned_docs/version-5.x/deep-linking.md +++ b/versioned_docs/version-5.x/deep-linking.md @@ -362,6 +362,6 @@ To solve this, you need **Deferred Deep Linking**. This technique allows the lin React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: -- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by [**Software Mansion**](https://swmansion.com). - [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. - [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. diff --git a/versioned_docs/version-6.x/deep-linking.md b/versioned_docs/version-6.x/deep-linking.md index 5f9e254575..0f36dd9eb9 100755 --- a/versioned_docs/version-6.x/deep-linking.md +++ b/versioned_docs/version-6.x/deep-linking.md @@ -327,6 +327,6 @@ To solve this, you need **Deferred Deep Linking**. This technique allows the lin React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: -- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by [**Software Mansion**](https://swmansion.com). - [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. - [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. diff --git a/versioned_docs/version-7.x/deep-linking.md b/versioned_docs/version-7.x/deep-linking.md index 208c9701c5..4b3bd26f87 100755 --- a/versioned_docs/version-7.x/deep-linking.md +++ b/versioned_docs/version-7.x/deep-linking.md @@ -526,6 +526,6 @@ To solve this, you need **Deferred Deep Linking**. This technique allows the lin React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: -- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by [**Software Mansion**](https://swmansion.com). - [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. - [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. diff --git a/versioned_docs/version-8.x/deep-linking.md b/versioned_docs/version-8.x/deep-linking.md index aea86cf4f0..1123efe5ad 100755 --- a/versioned_docs/version-8.x/deep-linking.md +++ b/versioned_docs/version-8.x/deep-linking.md @@ -478,6 +478,6 @@ To solve this, you need **Deferred Deep Linking**. This technique allows the lin React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: -- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by **Software Mansion**. +- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by [**Software Mansion**](https://swmansion.com). - [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. - [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. From 0f8024575d4f4b545accb455d21586222a670e0b Mon Sep 17 00:00:00 2001 From: Bartek Krason Date: Thu, 14 May 2026 16:29:49 +0200 Subject: [PATCH 3/3] docs: remove v5 and v6 deep links entry --- versioned_docs/version-5.x/deep-linking.md | 12 ------------ versioned_docs/version-6.x/deep-linking.md | 12 ------------ 2 files changed, 24 deletions(-) diff --git a/versioned_docs/version-5.x/deep-linking.md b/versioned_docs/version-5.x/deep-linking.md index b520f3bd00..bbc447119a 100755 --- a/versioned_docs/version-5.x/deep-linking.md +++ b/versioned_docs/version-5.x/deep-linking.md @@ -353,15 +353,3 @@ const linking = { ``` Similar to the above example, you can integrate any API that provides a way to get the initial URL and to subscribe to new incoming URLs using the `getInitialURL` and `subscribe` options. - -## What if the app is not installed? - -Standard deep links (Universal Links or App Links) only work if the app is already installed on the user's device. If a user clicks a link but doesn't have your app, they are redirected to the Store. Once they install and open the app for the first time, the original link context and its parameters (like a referral code or a specific product ID) are usually lost. - -To solve this, you need **Deferred Deep Linking**. This technique allows the link parameters to "survive" the installation process so you can route the user to the correct screen on their very first launch. - -React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: - -- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by [**Software Mansion**](https://swmansion.com). -- [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. -- [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution. diff --git a/versioned_docs/version-6.x/deep-linking.md b/versioned_docs/version-6.x/deep-linking.md index 0f36dd9eb9..e112f3f7f8 100755 --- a/versioned_docs/version-6.x/deep-linking.md +++ b/versioned_docs/version-6.x/deep-linking.md @@ -318,15 +318,3 @@ const linking = { ``` Similar to the above example, you can integrate any API that provides a way to get the initial URL and to subscribe to new incoming URLs using the `getInitialURL` and `subscribe` options. - -## What if the app is not installed? - -Standard deep links (Universal Links or App Links) only work if the app is already installed on the user's device. If a user clicks a link but doesn't have your app, they are redirected to the Store. Once they install and open the app for the first time, the original link context and its parameters (like a referral code or a specific product ID) are usually lost. - -To solve this, you need **Deferred Deep Linking**. This technique allows the link parameters to "survive" the installation process so you can route the user to the correct screen on their very first launch. - -React Navigation does not handle this natively, as it requires server-side attribution logic to work across both iOS and Android simultaneously. You will need to implement it yourself or use a third-party provider: - -- [**Detour**](https://docs.swmansion.com/detour): A flexible, developer-first library built by [**Software Mansion**](https://swmansion.com). -- [**Branch**](https://branch.io/): A platform for cross-platform deep linking and attribution. -- [**AppsFlyer**](https://www.appsflyer.com/): A platform focused on marketing analytics and mobile attribution.