Link Routing Rules (New)

Overview

This article explains how to configure your link settings in Branch. The Link Controls page allows you to manage link domains, customize link appearance, and configure routing rules for different platforms and devices.

To access these settings, go to Configuration > Link Controls in Branch.

The Link Controls page contains two tabs:

Link Appearance - Configure your link domains, social media previews, and QR code styling.
Link Routing Rules - Configure where users are redirected based on their platform and device.

The Link Routing Rules tab contains settings that control where users are redirected based on their platform, device, and app installation status.

Web Routing

Configure where to send users when they do not have your app installed.

Default URL

Enter your default fallback URL for links that do not have a specific redirect configured. This is where users will be sent if they don't have your app and no other redirect applies.

Redirect Allowlist

Limit link redirection to specific web domains or URI schemes across your Branch platform. List each of the domains you want to limit redirection to. Wildcard subdomains are supported using *.

For example, if your allowlist includes branch.io, *.branch.io, and myapp://, your deep links can only redirect to domains like branch.io, dashboard.branch.io, or myapp://.

Note
It is recommended that you include the app store domains that are relevant to the way users download your app, such as play.google.com and apps.apple.com.

Mobile Routing

Configure where to send mobile users based on their platform.

Android

Setting	Description
Android URI Scheme	Where to send your user if they have the app installed.
Android URL	Where to send users that do not have the app. This can be the Play Store or a custom link.
Android Package Name	Your app's package name from the Play Store.
Enable App Links	App Links will open URLs directly into an app, rather than the usual Link → Browser → App handoff cycle. This requires some set up, but Branch does this for you. You will need to provide your SHA256 certificate fingerprints.
SHA256 Certificate Fingerprints	Required for App Links. You can add multiple fingerprints by selecting Add another SHA256 fingerprint.

Note
The Play Store is for published apps. If your app cannot be located or is a local/dev build, please use the Custom URL option.

Generate SHA256 Cert Fingerprint

If you choose to enable App Links, you will need to generate a SHA256 Cert Fingerprint. Use one of the following methods:

KeyStore file method

Navigate to your keystore file (used to build the debug and production version of your APK file before it gets deployed).
Run keytool -list -v -keystore my-release-key.keystore to generate a fingerprint.

Android Studio method

In Android Studio, open the Gradle options from the top-right corner of the page by selecting the elephant icon.
Select the terminal icon. It will say "Execute Gradle Task" when you hover over it.
Enter --signingReport and press Enter/Return.
Select the cat icon to open logcat. Copy the SHA256 Cert Fingerprint from logcat at the bottom of Android Studio.

iOS

Setting	Description
iOS URI Scheme	Where to send your user if they have the app installed.
iOS URL	Where to send users that do not have the app. This can be the App Store or a custom link.
App Store ID	Your app's ID from the App Store.
Enable Universal Links	Universal Links will open URLs directly into an app, rather than the usual Link → Safari → App handoff cycle. This requires some set up, but Branch does this for you. You will need to provide your Apple App Prefix and Bundle Identifiers.
Bundle Identifiers	Required for Universal Links. Your app's bundle identifiers from Xcode. You can add multiple identifiers by selecting Add another Bundle ID.
Apple App Prefix	Required for Universal Links. Retrieve your Apple App Prefix from your Apple Developer account on the App IDs page. Branch only supports one Apple App Prefix with multiple bundle IDs.
Enable NativeLink™	NativeLink™ uses the local device clipboard to provide guaranteed deferred deep linking. Users will be presented with a landing page and CTA that copies the deep link to their clipboard. When the user installs the app, the app will automatically receive the deep link they copied. Requires iOS SDK 1.39.4 or higher and a Pasteboard Check Method call.
Audience Rule	When NativeLink™ is enabled, select the appropriate audience for this feature (e.g., All iOS Traffic).

Advanced Settings

These settings apply to both web and app links.

URI Scheme Deep Link Mode

This selector allows you to control how and when Branch uses URI schemes to open your app when Universal Links and Android App Links fail.

Mode	Description
Conservative	Conservative mode will never use URI schemes if there is a risk of error messages.
Intelligent	Recommended. Intelligent mode uses Branch data to safely use URI schemes everywhere, with the slight risk of error messages in certain browsers if the app is uninstalled.
Aggressive	Aggressive will force URI schemes everywhere, causing users without the app to see error messages in some browsers.

Match Type

Setting Match Type determines the matching methodology Branch uses for your Links and App.

Type	Description
Normal	Recommended. Branch will make a deep link through install match based on available footprint data.
Unique	Branch will only make a deep link through install match if there is a single, unique outstanding footprint. This is mostly for very special circumstances.

Other Advanced Settings

Setting	Description
Analytics mapping with UTM	When redirecting to a web URL, Branch automatically passes through any values from the following Branch Link analytics tags as UTM parameters: ~campaign → utm_campaign, ~channel → utm_source, ~feature → utm_medium. If these UTM parameters are already detected on the URLs being redirected to, Branch will not overwrite them.
Enable link scraping	Dynamic links will scrape from appended query parameters like $original_url, $fallback_url, and $desktop_url for meta tags. This ensures social link previews populate correctly for dynamic content.
Retrieve Last Attributed Touch Data via SDKs	Allows the app to fetch link data through the SDK rather than persisting it locally. Use this to implement post-onboarding or deferred deep linking.

Desktop Redirects

Configure where to send users accessing your links from desktop devices.

Default Desktop

Select one of the following options:

Branch-hosted QR Code Landing Page - Display a QR code that users can scan to open the link on their mobile device
Custom Landing Page - Redirect to a custom URL of your choice

Mac Desktop

Setting	Description
Mac URI Scheme	The URI scheme to open your Mac app if installed.
Mac App Store URL	The URL to your app in the Mac App Store.

Windows Desktop

Setting	Description
Windows URI Scheme	The URI scheme to open your Windows app if installed.
Windows Store URL	The URL to your app in the Windows Store.
Windows Package Family Name	Your app's Package Family Name from the Windows Store.

Note
If the app is not installed when the link is selected, the user will be redirected to the Desktop URL or Default URL, in that order.

Advanced Mobile Redirects

These settings allow you to specify different destination URLs or app store listings for users accessing your content on various mobile devices and platforms.

Amazon Fire Redirects

Enter your optional Amazon Fire URL. If blank, users will be redirected to your current Android default setting.

If you have a different package for the Amazon Store than the Play Store on Fire devices, specify the Amazon Fire URL here using the p=package parameter.

iPad Redirects

Enter your optional iPad URL. If you have a different App Store ID for your iPad app or would prefer to fall back to a different URL on iPad tablets, specify either URL here.

Android Tablet Redirects

Enter your optional Android Tablet URL. If blank, users will be redirected to your current Android default setting.

If you have a different Play Store package for your tablet apps or would prefer to fall back to a different URL on Android tablets, specify either URL here.

WeChat Redirects

Enter your optional WeChat URL. If blank, users will be redirected to the Default URL.

Note
WeChat does not support deep linking out of the app on iOS or Android. If you choose to fall back to a custom URL, you can enter it here.

Save your changes

After making changes on the Link Routing Rules tab, select Save changes to apply your settings.