Configuring deep links for Dub custom domains

If you haven't already, add a custom domain to your Dub workspace. If you're on a paid plan on Dub, you can also claim a complimentary .link custom domain and use it as your short link domain.

Once you've set up your custom domain, you'll need to upload your deep link configuration files to Dub, which we'll host under the /.well-known/ directory of your domain.

To do that, go to your workspace domain settings page and click on the edit button for your custom domain:

In the domain modal, click on Show advanced settings, which will open up the Deep Link Configuration settings fields.

iOS (apple-app-site-association)

For iOS apps, upload your Apple App Site Association file to enable iOS deep links:

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "YOUR_APP_ID",
        "paths": []
      }
    ]
  }
}

Android (assetlinks.json)

For Android apps, upload your AseetLinks file to enable Android deep links:

[
  {
    "target": {
      "namespace": "android_app",
      "package_name": "YOUR_PACKAGE_NAME",
      "sha256_cert_fingerprints": []
    },
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ]
  }
]

Once you've set up your deep link configuration files, you can go to their respective URLs to verify that they've been configured correctly:

iOS: yourdomain.link/.well-known/apple-app-site-association (example)

Android: yourdomain.link/.well-known/assetlinks.json (example)

Last but not least, you'll need to whitelist your short link domain in your apps to allow them to redirect straight into a page within your app.

For iOS apps, you'll need to allow websites to link to your apps.

For Android apps, you'll need to verify your Android app links.