Deep Link Tester

How do I test a deep link?

1. 1

   Enter the domain or link

   Type the domain that hosts your files, a deep link URL on it, or both.

2. 2

   Run the test

   The tester fetches the AASA and assetlinks.json files from /.well-known/ on that domain.

3. 3

   Read the checks

   Each check shows pass, warning, or fail, with a fix for anything that is not a pass.

4. 4

   Test on a device

   Copy the adb or xcrun command, or scan the QR code, and open the link on a phone or simulator.

How does the deep link tester check AASA files?

The deep link tester runs the basic iOS file checks and matches your link path against the rules. For a dedicated check of the file itself, use the AASA validator.

How does the deep link tester check assetlinks.json?

This tester runs the basic Android file checks and gives each failure a fix. For a dedicated check of the file itself, use the Android assetlinks validator.

What does a passing result look like?

On iOS, the AASA file lists your app ID and the paths or components the app opens. On Android, assetlinks.json lists the package name and the SHA-256 fingerprint of your signing certificate. The deep linking guide explains how both link types work.

What does a worked example look like?

Say you test the link https://go.example.com/p/42 and the AASA file at go.example.com contains this rule:

{
  "applinks": {
    "details": [
      {
        "appIDs": ["ABCDE12345.com.example.app"],
        "components": [{ "/": "/p/*" }]
      }
    ]
  }
}

The path /p/42 matches the rule /p/*, so the path check passes. A link to /about would fail with a fix that suggests adding a rule for that path. With a package in assetlinks.json, the Android command comes out as:

adb shell am start -W -a android.intent.action.VIEW -d "https://go.example.com/p/42" com.example.app
xcrun simctl openurl booted "https://go.example.com/p/42"

What about people who have not installed the app yet?

A Universal Link or App Link opens the app when it is installed. For people who install first, see deferred deep linking.