Software Mansion: How to Integrate Deferred Deep Linking in Flutter
Original post How to Integrate Deferred Deep Linking in Flutter
Article Summary
Bartek Krasoń and Mateusz Turbański from Software Mansion tackle one of mobile's trickiest UX problems: getting users to the right screen after they install your app from a link. Their solution using Detour eliminates the dreaded "generic home screen" landing.
This technical guide walks through implementing deferred deep linking in Flutter apps, where users who click a link before installing still land on the intended destination screen on first launch. The authors demonstrate integration with Detour, a developer-focused SDK that handles the attribution gap between link click and app install across iOS and Android.
Key Takeaways
- Deferred links survive app installation, routing users to specific screens on first open
- Detour SDK uses explicit consume semantics to handle auth gates cleanly
- iOS requires probabilistic matching due to lack of install referrer API
- Single routing code branch handles deferred, App Links, and scheme links
- Default matching score of 850 and 15-minute time window are customizable
The guide provides production-ready Flutter code for deferred deep linking that elegantly handles auth gates, prevents duplicate triggers, and works across both platforms with a unified API.
Continue reading
Flutter
Sep 30, 2020
More from Software Mansion
How to Add Deferred Deep Linking to Your iOS App
Software Mansion
Aug 24, 2026
Also on Flutter
Bring 3D to Life in Flutter with flutter_scene and Flutter GPU
Kasikornbank
Oct 14, 2026
What This Article Covers
Before deferred linking works, developers need to set up platform-specific credentials. On iOS that means the Bundle ID, Team ID, and App Store ID; on Android it's the package name and SHA-256 certificates.
Bartek Krasoń and Mateusz Turbański walk through installing detour_flutter_plugin, which needs Flutter 3.3.0 or higher, Dart ^3.11.1, Android SDK 24, and iOS 13.0+. On web, macOS, Linux, and Windows it falls back to a no-op implementation.
Teams get cross-platform flexibility because the plugin builds and runs on all six targets without needing conditional imports. Short links also replace unwieldy multi-parameter URLs when sharing publicly.
This page summarizes “How to Integrate Deferred Deep Linking in Flutter” by Software Mansion, published Oct 19, 2026. All credit for the original work goes to the authors.
