How to Implement Branch Deep Linking in Flutter

Deep linking is a powerful technique that takes users exactly where they need to go within an app, skipping the generic home screen and landing on the desired content or specific section. By enabling direct navigation, deep linking streamlines the user journey, enhances engagement and delivers a smoother, faster app experience.

• You receive an Instagram reel shared via WhatsApp. A simple tap doesn’t just open Instagram – it takes you straight to the reel, making the whole process seamless.
• A friend invites you to a fitness app using a referral link. Click the link, and you're not only directed to the app’s sign-up form but the referral code is automatically passed along, ensuring you never miss out on the benefits.
• Someone sends you a song via YouTube. When you tap the link, the YouTube app launches and the song starts playing instantly
• New users clicking on onboarding emails can be directed to specific parts of the app, such as tutorials or account setup screens.
• Event Invitations, Marketing Campaigns, Customer Support, etc.

Deep linking plays a crucial role in driving user retention, improving user experience, and enhancing app marketing strategies.

• App Detection: The system uses a domain URL to check if the app is installed on the device (iOS/Android).
• Link Handling: Once the app is found, a listener function kicks in, waiting for incoming links.
• Navigation: The app handles the link, determining where the user should land, based on the data or route embedded in the link.

Now, what if the user does not have the application installed?

Branch.io offers the best of both worlds: not only deep links but also the magic of deferred links, making sure your users never miss a beat, even if they’re new to your app.

Next, head over to the Configuration tab in the dashboard’s menu to start setting up your Android and iOS platforms.

1. Android URI scheme: It has to be in this format “<Your App Name>://”. Anyway, the field in the dashboard guides you with the format.
2. Check on the “I have an Android app” option. If you are already live then search your app on PlayStore or select Custom URL - your app’s Play Store listing (e.g., https://play.google.com/store/apps/details?id=com.example.yourapp). This is to make sure that if the app is not installed then the fallback re-direction is set.
3. Check on the “Enable app links” option. You are supposed to provide SHA-256. Input the SHA-256 fingerprint of your app's certificate (used to sign your APK). This ensures Branch can verify your app’s authenticity.

To get this fingerprint, run the following command in your terminal:

1. iOS URI scheme: Same as Android configuration. “<Your App Name>://” .
2. Check on the “I have an iOS app” option. If you are already live then search your app on the AppStore or select Custom URL. Input your app’s Apple App Store ID. You can find this in your app’s App Store listing URL. - e.g. https://apps.apple.com/app/id123456789, then 123456789 is your App Store ID.
3. Enable Universal Links. Enter your app’s bundle identifier (e.g., com.example.yourapp). This must exactly match the bundle ID specified in your Xcode project under General > Identity. Enter your Apple Developer Team ID in place of the Apple App prefix.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXd3mP5Nvw5-VZURRzHJ0k2QmZ-gB7zOrfQBxiTsQ8yEeZ7HdBtQvCTrZt-gYqRZW_2MTEK_YxrwHks8UCjF7i5PgW2NUPX1AsvUdcvOanXGiBhRGH7GpQqicuHDlVMfn4889B_4p_S4N3LV3t8iIkncgCM?key=oXUjUcRztgxOBV21Q_ENkw

You can easily find the plugin here flutter_branch_sdk

In your main AndroidManifest.xml file, make the launchMode to SingleTask to ensure only one instance of the activity exists at a time. If an instance already exists, it will bring it to the foreground instead of creating a new instance.

Note: If you are developing in Test mode then io.branch.sdk.TestMode should be set to true.

The first step is to ensure that your Bundle Identifier in Xcode matches the Bundle ID you set during the Branch configuration.

In Xcode, navigate to the Capabilities section and enable Associated Domains. Simply click the "+" button to add the domain links generated by Branch.

Coming to Info.plist to add Branch key, domain links and URI scheme.
For domain link :

For URL scheme :

For Branch Key:

Start by importing the Flutter Branch SDK into your main.dart file, then initialize it to get everything up and running.

To ensure everything is set up correctly, you can verify the SDK integration by running the following command:

After validating, you can comment this line.
Now, let’s set up listener to capture deep link clicks and retrieve the embedded data that comes along with them:

The process of generating a link follows a straightforward formula!
To make things clearer, let’s dive into a practical example and walk through the integration step by step. It’s always easier to grasp when you see it in action!

First, we encapsulate the content and metadata of what we want to share using BranchUniversalObject. This object acts as the core of your content, carrying details like the title, description, and other relevant information.
To define how the link behaves and If you are keen on tracking the performance of your links—be it through analytics or specific campaigns—fine-tune the link’s behaviour using BranchLinkProperties - Here, you can specify important elements like tags, channels, campaigns, and other tracking parameters.

It is required to provide Link properties before we can generate the branch link.
In our use case, for sharing of post: 

Finally, generate the link

In the use case above, handling routing within the listener is essential. Since the postId value is extracted from the deep link, you can use it to fetch the full post details from your backend. To navigate to the correct screen, simply adjust your navigation logic.
It will look something like this:

The code above seamlessly manages deep links whether the app is running, in the background, or opened from a cold start (completely closed). When the app launches via a Branch link, even from a cold start, the deep link data is passed through the initSession() method, ensuring smooth navigation.
Branch links are more than just links—they’re intelligent!
Branch’s smart links work effortlessly across platforms. If the app is not installed, these links automatically detect the user’s platform and redirect them to the appropriate destination—whether it's Google Play or the App Store. For apps not yet live, you can easily set up a fallback URL to guide users. If your app is live, just configure the Branch dashboard to point directly to your app’s store listing. It’s that simple—whether for deep linking or deferred linking, Branch handles it all with ease!

Excited to explore these possibilities even further—stay tuned!