Revision history [back]

To set up a subdomain for Apple app site association, follow these steps:

1. Log in to your domain registrar and navigate to the domain management dashboard.

2. Add a new DNS record for the subdomain you want to use for the app site association file. The record should be a CNAME record that points to the root domain.

For example, if your main domain is example.com and you want to use the subdomain apps.example.com for the app site association file, the CNAME record should look like this:

apps CNAME example.com

1. Once the DNS record has propagated, create a new file called apple-app-site-association and save it in the root directory of the subdomain. The file should contain the JSON object with your app's details.

For example:

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TEAMID.BUNDLEID",
                "paths": [ "/path-to-content/*", "*" ]
            }
        ]
    }
}

Replace TEAMID and BUNDLEID with the respective values for your app.

1. Upload the file to the root directory of the subdomain using an FTP client or through your website's file manager.

2. Verify that the app site association file is accessible by visiting https://apps.example.com/apple-app-site-association in a web browser. The file should be displayed without any errors.

3. Test the app site association by sharing links to your app on social media, messaging apps, or other platforms. When clicked, the link should open the corresponding content in your app.

Note: The app site association file must be served over HTTPS and must not have any redirects or authentication requirements. It should also be accessible without any query parameters or paths.