Are you being redirected to the App Store (or fallback URL), even when your app is installed? Then you have come to the right guide!


A Branch link can open an iOS app with two mechanisms:

  • URI Schemes

  • Universal Links

In the next section, we will go over the areas that could be affecting this behavior.


TROUBLESHOOT COMMON ISSUES WITH BRANCH LINK NOT OPENING IOS APP


Step 1: Is it a Branch link?
Please make sure that the link you are testing with belongs to your app. This can easily be verified from the link domain that is present on your Branch Dashboard -> Link Settings -> Link Domain. The domain of the link should match the domain on your Link Settings page.



Step 2: Did you configure your Link Settings on the Branch dashboard?
Please make sure you have filled out Branch Dashboard -> Link Settings -> iOS redirects and have selected ‘Universal Links’ checkbox. Also, you need to make sure that your Team ID (ios_team_id) and Bundle ID (ios_bundle_id) correctly entered here. If you don’t know what these are, head over to https://developer.apple.com/account and retrieve it from the Membership section.

 


Step 3: Did you configure your app's Info.plist?
Please verify that your URI scheme is correctly entered into your Info.plist file as documented here. This URI scheme should match what is entered on Branch Dashboard -> Link Settings -> iOS redirects -> URI Scheme.



Step 4: Does your app have the correct Entitlements file?
Please ensure that your Entitlements file is added to the correct target build as documented here.


Step 5: Did you add the link domains in your Associated Domains?
Make sure that you have entered the 'applinks:<domain>' in the Associated DomainsFor your app to open via Journeys or a Deepview, you will also need to add the Branch alternate subdomain to the Associated Domains as documented hereYou can also use our Universal Link Validator to check for in-app setup in Steps 2, 3, 4 & 5.



Step 6: Where are you clicking the link from?

Please note that certain apps do not yet provide support for iOS Universal Links. We maintain a list of such apps here. If you are clicking the link from one of these apps, there are chances that your Universal Links might not work. We suggest that you use Branch Deepviews in that case.


Step 7: Are Universal Links disabled on your device?

Universal Links, unfortunately, can sometimes get disabled. Please follow to guide here to re-enable Universal Links on your device. Also, please make sure that you go through the common Universal Links issues here.


Use the interactive troubleshooting guide to resolve common iOS app not opening issues.


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.