Branch link opens an iOS app via two mechanisms:

  • URI Schemes
  • Universal Links


To ensure that the link opens your iOS app, please check the following:

  • Link Settings on the Branch dashboard
  • Info.plist file of your app (needed for URI Schemes)
  • Entitlements file of your app (needed for Universal Links)


Under your Link Settings (https://dashboard.branch.io/link-settings), please confirm that you have:

  • Checked 'I have an iOS App'
  • Entered an iOS URI Scheme
  • Checked 'Enable Universal Links'
  • Entered the Team ID and Bundle ID from your Apple Developer Account


Under your app configuration in your Xcode project, please confirm that you have:


As a sanity check, feel free to use our Universal Link Validator:


At this point, a basic Quick Link on the dashboard should launch your app from the native Notes app. Oftentimes, the configuration is correct, but a Branch link could have special redirects or control parameters that prevent it from opening the app. To verify that this is the issue, append '?debug=true' at the end your test link (e.g. https://branch.app.link/abcd123?debug=1) and enter it on your desktop. Under Link Data, ensure that 'has_app' and '$always_deeplink' are not set to 'false'.


Lastly, if the Branch link still does not open the app, it might be that you are clicking the Branch link from an app or browser that does not support Universal Links. Please take a look at the limitations here:


If all else fails, feel free to submit a ticket down below with your Branch key, Branch link, screenshots of Entitlements and Info.plist files, and test plan in the description. This information will help us reach a quicker resolution. Thanks for your support!