Platform-Knowledge-Base/troubleshooting/cannot-open-custom-url-scheme-from-ios-app.md

title	description	type	page_title	slug	position	tags	ticketid
Deep Linking Does Not Work on iOS Devices	Opening an external app from an iOS app using a custom URL scheme doesn't work	troubleshooting	Links with Custom URL Schemes Do Not Work on iOS Devices	deep-linking-not-working-on-ios-devices		deep linking, custom url scheme, googlegmail, comgooglemaps, iOS	1062970

Environment

Service	{{site.ab-s}} ({{site.ab}})
Feature	Run on Device
Mobile development type	Hybrid ({{site.ac}} app)
Mobile OS	iOS

Description

Links in your app, that use a custom URL scheme (for example, googlegmail://) to open an external app, do not work on iOS. Clicking such a link produces no visible result. This problem is observed on iOS 9 and newer versions.

Cause

Apple introduced a new LSApplicationQueriesSchemes key in the iOS Info.plist file that lists the URL schemes the app is able to open. If this property is not set in your app, you will not be able to link using any custom URL schemes.

Solution

You need to whitelist all custom URL schemes that you intend to use in your app. To do this, follow the steps below:

1. In {{site.ab}}, right-click your project name and select Edit Configuration -> iOS Info.plist.

2. Add the following right before the last closing </dict> tag:

   <key>LSApplicationQueriesSchemes</key>
   <array>
   	<string>customscheme</string>
   	<string>customscheme</string>
   	<string>customscheme</string>
   </array>
   

   where you replace customurlscheme with the names of the custom URL schemes that you want to use. For example, fb, googlegmail, comgooglemaps.

3. Save and re-build your app.

See Also

• iOS Launch Services Keys Documentation