Basic Link Configuration

  • Published on May 13, 2025
Prev Next

Overview

This guide helps you configure link behavior for redirects and link domains.

It covers various settings such as default link behavior for different operating systems (Android, iOS), social media preview customization, and link domain selection.

The guide also explains advanced settings like URI scheme deep link mode, redirect allowlist, and UTM tag usage for analytics. Additionally, it discusses desktop app default link behavior, advanced mobile redirects, and provides a table mapping UTM parameters to Branch parameters.

1. Default link behavior

Caution

This is a required setting.

In the left-side navigation of the Branch Dashboard, find the App Settings page under Configure. Find the General tab, and in the the Required Redirects section, enter in your fallback URL for mobile devices that do not have a specified redirect.

2. Android default link behavior

Caution

This is a required setting.

Complete the following steps to configure the default behavior for your deep links:

  1. In the Branch Dashboard, navigate to App Settings → General tab → Required Redirects section → Android Redirects.

  2. Use the settings in this section to control the default behavior of your deep links on Android.

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 to do this:

KeyStore file method

  1. Navigate to your keystore file (used to build the debug and production version of your APK file before it gets deployed).

  2. Run keytool -list -v -keystore my-release-key.keystore to generate a fingerprint.
    * Example fingerprint:
    AA:C9:D9:A5:E9:76:3E:51:1B:FB:35:00:06:9B:56:AC:FB:A6:28: CE:F3:D6:65:38:18:E3:9C:63:94:FB:D2:C1 to add to your Branch Dashboard.

Android Studio method

  1. In Android Studio, open the Gradle options from the top-right corner of the page by selecting the elephant icon.

  2. Select the terminal icon. It will say “Execute Gradle Task” when you hover over it.

  3. Enter --signingReport and press Enter/Return.

  4. Select the cat icon to open logcat. Copy the SHA256 Cert Fingerprint from logcat at the bottom of Android Studio.

3. iOS default link behavior

Caution

This is a required setting.

Use these settings to control the default behavior of your deep links on iOS.

  1. In the Branch Dashboard, navigate to App Settings → General tab → Required Redirects section → iOS Redirects.

  2. If you choose to Enable Universal Links, you will need to enter your Apple App Prefix which can be found within the Apple Developer Portal for your app.

  3. To enable deferred deep linking via NativeLink™, you can click the Enable NativeLink™ checkbox. Doing so means your users will be presented with a Deepview that lets them continue their experience in an app, even if they don’t have it installed.

    1. Make sure to choose the appropriate audience in the Audience Rule dropdown.

    2. Please ensure your iOS URI Scheme and Universal Links are properly configured.

    3. Once enabled, follow the instructions in our developer documentation to use NativeLink™.

Warning

For any user running on an iOS version below 12.3, a popup first appears prompting the user to open in the App Store when being redirected to the app store. The user must click OK to be fully routed to the App Store to download your app. This popup cannot be removed from the user flow as it's inherent to iOS.

4. Social media preview

  1. In the Branch Dashboard, navigate to App Settings → General tab → Social Media Preview section.

  2. Fill in the following fields to customize how the link to your install page will look when shared or re-shared on social media:
    a. Link Title
    b. Description
    c. Thumbnail Image

5. Link domain

To see your app’s default link domain and alternate link domain, navigate to the General tab of the App Settings page of the Branch Dashboard.

When you first create your account, you will be assigned a unique domain for all of your Branch Links.

Change link domain

Caution

Before changing your Branch link domain, it is important to understand all behavior changes that occur when you do so. This will help ensure you do not run into any unwanted experiences for your users clicking your Branch Links.

Change

Example

Behavior

app.link to app.link

abcdef.app.link → mycompany.app.link

  • Your old app.link URLs will redirect to the LINK NOT FOUND page.

  • Your old app.link URLs will fail to open your mobile app.

  • Your new app.link URLs will not open your app until you update your code to utilize the new link domain (iOS / Android).

  • If you are already using your original/old app.link URLs in the wild and need them to keep working, it is recommended to explore Using Your Own Domain instead.

app.link to Custom Domain

mycompany.app.link → app.mycompany.com

  • Your old app.link URLs will still work.

  • Your new Custom Domain URLs will not open your app until you update your code to utilize the new link domain (iOS / Android).

  • Creating Long Links Details

Custom Domain to Custom Domain

app.mycompany.com → mycompany.app

  • Your old Custom Domain URLs will fail to deep link.

  • Your new Custom Domain URLs will not open your app until you update your code to utilize the new link domain (iOS / Android).

Legacy bnc.lt to app.link or Custom Domain

bnc.lt → mycompany.app.link

bnc.lt/branch → app.mycompany.com

  • Both your bnc.lt and app.link/Custom Domain deep links will work.

  • Your new app.link/Custom Domain URLs will not open your app until you update your code to utilize the new link domain (iOS / Android).

Change app.link subdomain

Caution

Changing your app.link subdomain can only be performed once for your Branch app.

You have the ability to change your app.link subdomain for your Branch Links to better match your brand. It is recommended to set your app.link subdomain to be the name of your app, in case you have multiple mobile apps under your brand.

To customize your app.link subdomain:

  1. Review and understand what it means to change your domain.

  2. Click the Change My app.link Subdomain button.

  3. Input your new preferred app.link subdomain. You can only set it to a subdomain that is not already taken by another Branch app.

  4. Update your mobile app to use the new app.link subdomain.

Use your own domain

You have the ability to use your own custom domain to be used for your Branch Links. Branch supports the use of a custom subdomain or a custom root domain for you to be able to set your Branch Links closer to your branding preferences.

Warning

Do not use your main website domain for your Branch Links.

Caution

  • Whenever you change the NS or CNAME records of your domain, you are making Branch the authoritative registrar of your domain. This will grant Branch control of your domain and you will lose access to that custom subdomain or custom root domain. The web page will become blank, and the control of the domain will change to Branch

  • Branch will use the domain to route all deep linked traffic.

  • Branch will host your AASA file and SSL certifications.

  • If you have content on your custom root domain, Branch recommends using an unused custom subdomain.

Limitation

Details

Android App Links & Web Limitations

Android App Links together on custom subdomains and custom root domains currently do not support Branch's web-only link functionality. Using the $web_only parameter on Branch Links that only open the web even if the app is installed. Because of this limitation, Android App Links will force the app to open even when using the $web_only parameter.

Web

If you have Activation, you can use a custom domain for Web Quick Links. For other packages, you must use the assigned default link alias.

Use a custom subdomain

If your enterprise is highly restrictive of the domains that you utilize and wants to ensure that your Branch domain matches the rest of your relevant subdomains, you can utilize a custom subdomain, for example link.yourbrand.com .

To set a custom subdomain:

  1. Review and understand what it means to change your link domain.

  2. Update the DNS CNAME of your custom subdomain to point to custom.bnc.lt . If using AWS Route 53, do this in the Registered Domain tab, not in Hosted Zones.

  3. Use the CAA Lookup Tool to see if you need to update your CAA records of your custom subdomain to include letsencrypt.org.

  4. Click the Use My Own Domain button.

  5. Input your custom subdomain (without the www ) and click Confirm.

  6. Update your mobile app to use the new custom subdomain.

Use a custom root domain

If your enterprise requires you to establish an entirely separate domain for your Branch domain, you can use a custom root domain, for example yourbrand-link.com. This is only recommended if your company is not open to app.link or a custom subdomain option.

To set a custom root domain:

  1. Review and understand what it means to change your link domain.

  2. Update the NS records of your custom root domain using the following nameservers:

    • ns-1581.awsdns-05.co.uk

    • ns-234.awsdns-29.com

    • ns-1059.awsdns-04.org

    • ns-843.awsdns-41.net

  3. Use the CAA Lookup Tool to see if you need to update your CAA records of your custom subdomain to include letsencrypt.org.

  4. Click the Use My Own Domain button.

  5. Input your custom root domain (without the www) and click Confirm.

  6. Update your mobile app to use the new custom subdomain.

Next steps

For steps on how to configure the other settings in the General tab, visit our Advanced Settings and Additional Settings guides.