Apple App Site Association Generator

Universal Links & AASA Validator

Generate and validate Apple-compliant apple-app-site-association (AASA) JSON files, verify URL path components, and configure Xcode Associated Domains.

Apple App Credentials & Domain

Apple Developer Team ID:

10-character alphanumeric ID from Apple Developer account.

Bundle Identifier:

Matches your Xcode Target Bundle Identifier.

Domain Name:

Domain hosting the AASA file.

Universal Link URL Path Patterns (one per line):

apple-app-site-association (AASA)

Host at: https://example.com/.well-known/apple-app-site-association

{
  "applinks": {
    "details": [
      {
        "appIDs": [
          "9JA89QQLNQ.com.example.myapp"
        ],
        "components": [
          {
            "/": "/product/*",
            "comment": "Match dynamic route path"
          },
          {
            "/": "/profile/*",
            "comment": "Match dynamic route path"
          },
          {
            "/": "/invite/?*",
            "comment": "Match dynamic route path"
          }
        ]
      }
    ]
  },
  "webcredentials": {
    "apps": [
      "9JA89QQLNQ.com.example.myapp"
    ]
  }
}

Xcode Associated Domains Entitlement

<key>com.apple.developer.associated-domains</key>
<array>
    <string>applinks:example.com</string>
    <string>applinks:www.example.com</string>
</array>

AASA Web Server Hosting Requirements

1.Serve over HTTPS with a valid, trusted TLS/SSL certificate (no self-signed certificates).

2.File must have NO extension (do not name it .json).

3.Return HTTP header Content-Type: application/json.

4.Do not use HTTP 301/302 redirects when serving the file. Apple’s scraper will abort.

Why Universal Links are superior to Custom URL Schemes

Seamless Web Fallback

If the app is installed, tapping a link opens the app directly without Safari opening. If uninstalled, the user falls back gracefully to your mobile website.

Secure Domain Verification

Unlike custom schemes which any third-party app can claim, Universal Links verify domain ownership cryptographically through your web server’s AASA file.

Apple CDNs Cache AASA

Apple’s app site association scraper periodically caches your AASA JSON on Apple CDN servers when users install or update your app from the App Store.

Build full iPhone apps without touching Xcode

Enjoying this free Universal Link Validator? Thorous turns your natural language prompts into compiled native SwiftUI apps, with real-time iOS simulator streaming and visual on-screen editing.

Get Thorous from $3.99/mo Explore Thorous features

Native Mac app · macOS 14 Sonoma or later · Apple silicon & Intel