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
Navigate to the Branch dashboard and go to Link Settings
- Scroll to the bottom of the page to Link Domain and click the 'Convert to app.link'
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:
Add new custom subdomain to the Associated Domains section of your entitlements file:
Android App Setup:
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
Update to the latest version of the app with the new subdomain added to it
Grab an XXXX.app.link and paste in Notes
The link should trigger the app to open!
Did you find it helpful?Send feedback