The Telerik Platform product is retired.Learn more

Deep Linking Does Not Work on iOS Devices


Service Code (AppBuilder)
Feature Run on Device
Mobile development type Hybrid (Apache Cordova app)
Mobile OS iOS


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.


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.


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 AppBuilder, right-click your project name and select Edit Configuration -> iOS Info.plist.
  2. Add the following right before the last closing </dict> tag:


    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

Contact us: +1-888-365-2779
Copyright © 2016-2018, Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.