Why this matters: On July 26th 2016, Branch launched a subdomain, app.link, that allows partners to customize their link domain. 


Objective: This walkthrough will demonstrate how to move from the bnc.lt link domain to your own custom, Branch-hosted subdomain (app.link).  Please note, this will require an app release.


Step One: Choose your subdomain

  1. Navigate to the Branch dashboard and go to Link Settings 

  2. Scroll to the bottom of the page to Link Domain and click the 'Convert to app.link'

  3. Select your custom subdomain

    • NOTE: You’ll notice that all links created after this change will be XXXX.app.link URLs


Step Two: App changes needed for the new subdomain

You will need to make adjustments to the app code in order to have the new links function with the app. Please add the following to your app and do not remove older domains (e.g. bnc.lt), so that your old links will work. 


iOS App Setup:

  1. Add new custom subdomain to the Associated Domains section of your entitlements file: 

    1. -alternate is needed for Universal Linking with the Web SDK inside your website

    2. test- is needed if you need to use a test key


Android App Setup:
  1. Within your AndroidManifest.xml, you will need to change the following XML block in the Intent Filter, example below:

<data android:scheme="https" android:host="bnc.lt" android:pathPrefix="/XXXX"/>


You will add the following XML block:

<data android:scheme="https" android:host="<XXXX.app.link"/>

<data android:scheme=”https” android:host=”<XXXX-alternate.app.link”/>

<data android:scheme="https" android:host="<XXXX.test-app.link"/>

<data android:scheme=”https” android:host=”<XXXX-alternate.test-app.link”/>



Step Three: Testing new link app.link URL 

  1. Update to the latest version of the app with the new subdomain added to it 

  2. Grab an XXXX.app.link and paste in Notes 

  3. The link should trigger the app to open!