# FlutterFlow deep linking

> How deep linking works in a FlutterFlow app, how to make Strait links open the right FlutterFlow page through a custom scheme, and when to move to exported code and the Flutter SDK for verified links and deferred deep links.

Source: https://straitlink.in/guides/flutterflow-deep-linking/
Markdown: https://straitlink.in/guides/flutterflow-deep-linking.md

- [Guides](https://straitlink.in/guides/)
- FlutterFlow

# 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](https://straitlink.in/ai/#prompt-flutter)

STEPS · 4

- [1What FlutterFlow does with a link](https://straitlink.in/guides/flutterflow-deep-linking/#what-flutterflow-does-with-a-link)
- [2Option 1: no code, custom scheme only](https://straitlink.in/guides/flutterflow-deep-linking/#option-1-no-code-custom-scheme-only)
- [3Option 2: exported code and the Flutter SDK](https://straitlink.in/guides/flutterflow-deep-linking/#option-2-exported-code-and-the-flutter-sdk)
- [4Picking between them](https://straitlink.in/guides/flutterflow-deep-linking/#picking-between-them)

**Step 1 of 4**What FlutterFlow does with a link

AT A GLANCE · FLUTTERFLOW

- Builds on : `strait_sdk`

- Platforms : Android, iPhone

- Start in the docs : [Flutter: install & set up](https://straitlink.in/docs/sdks/flutter/)

- Free plan : 25,000 taps a month, no card

## 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 the `product` page opens with `id` 42. 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](https://straitlink.in/docs/sdks/flutter/) 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` = `false` on Android, `FlutterDeepLinkingEnabled` = `NO` on iPhone), so the SDK sees links first.

- Call `startLinks()` before `runApp`, and in `links.onLink` call the generated router with `e.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](https://straitlink.in/docs/sdks/flutter/test/) covers checking a deferred link from Google Play once you do.

[Open the FlutterFlow docs](https://straitlink.in/docs/sdks/flutter/)

Docs for this setup

## Where to go next for FlutterFlow

- [Flutter: install & set up The package, its helpers and the native settings](https://straitlink.in/docs/sdks/flutter/)
- [Flutter: receive links Route with go_router or a navigator key](https://straitlink.in/docs/sdks/flutter/receive-links/)
- [Flutter: test Check a deferred link from Google Play](https://straitlink.in/docs/sdks/flutter/test/)

Check your setup

## Free tools for the parts that usually break

- [Will it open my app? Simulate a tap from WhatsApp, Instagram or Chrome](https://straitlink.in/tools/will-it-open/)
- [assetlinks.json checker Is your Android App Links file right?](https://straitlink.in/tools/assetlinks-checker/)
- [AASA validator Is your apple-app-site-association file right?](https://straitlink.in/tools/aasa-validator/)
- [Troubleshooting When a link opens the browser instead of the app](https://straitlink.in/docs/troubleshooting/)

Other guides: [Expo](https://straitlink.in/guides/expo-deep-linking/) · [Next.js](https://straitlink.in/guides/nextjs-deep-linking/) · [Capacitor and Ionic](https://straitlink.in/guides/capacitor-deep-linking/) · [Jetpack Compose (Kotlin)](https://straitlink.in/guides/jetpack-compose-deep-linking/) · [SwiftUI](https://straitlink.in/guides/swiftui-deep-linking/) · [Unity](https://straitlink.in/guides/unity-deep-linking/)

## Ship links that open your FlutterFlow app.

Free for 25,000 taps a month, no card. Every tap gets a trace you can read.

[Start free](https://app.straitlink.in/?signup=1) [Read the quick start](https://straitlink.in/docs/quick-start/)
