Deep Linking

Deep linking directs users to open a specific page in a mobile app from a different app, such as a browser app, mail app, or any other app.

Required Editions

Setup for Mobile Publisher available in: Lightning Experience
Setup for Mobile Publisher available in: production only (not sandbox)
Available in Lightning Experience in: Enterprise, Performance, and Unlimited Editions

The two proven methods to set up deep linking are:

  • Custom URI scheme
  • Universal links (Android) or App links (iOS)
  Android iOS
  App Links Custom URI Scheme Universal Links Custom URI Scheme
Inbound
  • Available out of the box
  • Branded app only
  • Not supported on Publisher Playground app
  • Not Supported
  • Available out of the box
  • Branded app only
  • Not supported on Publisher Playground app
  • Not Supported
Outbound
  • Available out of the box
  • Supported in branded app and Publisher Playground app
  • Supported in branded app
  • Requires configuration on Mobile Publisher Setup UI in the Allowlist Custom URL Schemes field
  • Not supported on the Publisher Playground app
  • Note
    Note

    If custom URI schemes aren’t configured in the Allowlist Custom URL Schemes field, links fail with ERR_UNKNOWN_URL_SCHEME. The in-app WebView and browser can’t handle non-HTTP/HTTPS schemes.

  • Available out of the box
  • Supported in branded app and Publisher Playground app
  • Supported in branded app
  • Requires configuration on Mobile Publisher Setup UI in the Allowlist Custom URL Schemes field
  • Not supported on Publisher Playground app
  • Note
    Note

    If custom URI schemes aren’t configured in the Allowlist Custom URL Schemes field, links fail with ERR_UNKNOWN_URL_SCHEME. The in-app WebView and browser can’t handle non-HTTP/HTTPS schemes.

Note
Note Android now validates both the domain and the specific Experience Cloud site path when determining whether a URL belongs to your app, matching iOS behavior. This affects how deep links to URLs on the same domain as your Experience Cloud site are resolved. For details on URL handling precedence, see Manage How URLs Open from Your App.

Android and iOS use these files from any website to check if there’s a corresponding app.

  • apple-app-site-association
  • asset-links.json

Location of Android App Links configuration: <experience-site-url-without-s>/.well-known/assetlinks.json

Location of iOS Universal Links configuration: <experience-site-url-without-s>/apple-app-site-association

If you want to override the default files that are generated, you can use URL rewriter. See Rewrite URLs for Salesforce Sites.

  • Set Up URL Schemes
    You can specify URL schemes for other apps and send users to external content inside the Mobile Publisher app.
  • Use App Links with Mobile Publisher for Experience Cloud (Android)
    Mobile Publisher for Experience Cloud supports incoming and outgoing Android App Links.
  • Use Universal Links with Mobile Publisher for Experience Cloud (iOS)
    Mobile Publisher for Experience Cloud supports incoming and outgoing iOS Universal Links.
  • Override Android App Links to Your Mobile Publisher App
    Mobile Publisher for Experience Cloud apps support app links on Android. By default, when a user taps an app link to your Mobile Publisher app, the link opens to the page inside your app. To override the default behavior and set certain links to open outside of your app, use an Apex class and a Visualforce page. For example, if you want the link to your app’s registration page to open in a web browser.
  • Override iOS Universal Links to Your Mobile Publisher App
    Mobile Publisher for Experience Cloud apps support universal links on iOS. By default, when a user taps a universal link to your Mobile Publisher app, the link opens to the page inside your app. To override the default behavior and set certain links to open outside of your app, use an Apex class and a Visualforce page. For example, if you want the link to your app’s registration page to open in a web browser.