Deep links for FlutterFlow apps
FlutterFlow can route a custom-scheme URL to a page without code. Short links, verified links and the screen after install need a little more. Here is what works today and where the Flutter SDK comes in.
- Guide
- Android
- iPhone
strait_sdk- Faster: one prompt
What FlutterFlow does with a link
When you turn on deep linking in a FlutterFlow project, you choose a custom scheme and FlutterFlow generates the native settings and a router for it. A URL like yourapp://yourapp.com/product?id=42 then opens the page whose route is product, with id as a page parameter. Check the route of each page in its properties; it's the part of the URL that has to match.
That is enough for a large share of what people do with links, as long as the link carries the real page path.
Option 1: no code, custom scheme only
Set up your app in Dashboard → Apps & stores with the Android package name and the same custom scheme FlutterFlow uses. Then create links whose destination path is a FlutterFlow route, for example https://shop.example.com/product?id=42.
What happens on a tap:
- Android, browser or chat app: the link server sends the Android hand-off, an
intent://URL built from your destination with your scheme. Android opens your FlutterFlow app at/product?id=42, so theproductpage opens withid42. Without the app, the person goes to Google Play. - Inside Instagram or WhatsApp: the person gets a page with an Open in app button, which does the same hand-off on a tap.
- iPhone: without your app, the Get the app page and the App Store; the custom scheme alone doesn't bring the link through an install. The match after an App Store install is opt-in (off until you turn it on).
The hand-off adds a strait_click query parameter, the tap id. Page routing normally ignores parameters a page doesn't declare, so you can leave it, or declare it as a page parameter if you want to send it with purchases.
What you don't get this way: verified App Links (no chooser, no browser flash), the right page after an install, and open reporting in Analytics. Taps and store visits are still counted.
Before you send links, try the hand-off with adb shell am start -W -a android.intent.action.VIEW -d "yourapp://shop.example.com/product?id=42". If the page doesn't open, compare the path with the page's route, and the scheme with the one in FlutterFlow's settings.
Option 2: exported code and the Flutter SDK
For the full set, the Flutter SDK runs in your project's code. The Strait package is on pub.dev, so FlutterFlow's custom-code dependency list can add it, but the link set-up below changes the Android and iPhone projects, so it still means working in the downloaded or GitHub-pushed project:
- Add the package and its helpers to
pubspec.yaml, as in the Flutter install page. - Turn off Flutter's own deep linking for the link domain (
flutter_deeplinking_enabled=falseon Android,FlutterDeepLinkingEnabled=NOon iPhone), so the SDK sees links first. - Call
startLinks()beforerunApp, and inlinks.onLinkcall the generated router withe.path.
Keep your FlutterFlow route names stable once links are out in the wild; a renamed page breaks every link that points at it.
Picking between them
Start with option 1 if you mostly send links to people who already have the app, such as order updates on WhatsApp. Move to option 2 before you spend on install campaigns or referrals, where the screen after install is the whole point. The Test page covers checking a deferred link from Google Play once you do.
Docs for this setup
Where to go next for FlutterFlow
Check your setup
Free tools for the parts that usually break
Other guides: Expo · Next.js · Capacitor and Ionic · Jetpack Compose (Kotlin) · SwiftUI · Unity
Ship links that open your FlutterFlow app.
Free for 25,000 taps a month, no card. Every tap gets a trace you can read.