Understanding iOS Universal Links
iOS Universal Links allow standard HTTPS URLs to launch your native iOS application directly, bypassing Safari. If the app is not installed, the link opens seamlessly in Safari as an ordinary web destination.
Unlike outdated custom URL schemes (like myapp://), Universal Links cannot be hijacked by other applications on the user's device because domain ownership is cryptographically verified against your Apple Developer Team ID.
The Apple App Site Association (AASA) File
Apple requires an association file hosted at https://yourdomain.com/.well-known/apple-app-site-association. The file must be served over HTTPS without redirects, use Content-Type application/json, and be accessible to Apple's CDN scrapers.
Here is the modern JSON schema served automatically by Deeplio:
{
"applinks": {
"apps": [],
"details": [
{
"appIDs": ["TEAMID1234.com.yourcompany.yourapp"],
"components": [
{
"/": "/*",
"comment": "Matches all universal paths"
}
]
}
]
}
}Configuring Xcode Associated Domains
In Xcode, select your project target, navigate to Signing & Capabilities, and add the Associated Domains capability. Add your verified Deeplio domain with the applinks: prefix:
applinks:go.yourcompany.com
applinks:yourapp.deeplio.appHandling the In-App WebView Dilemma
A major limitation of Universal Links occurs when links are tapped inside apps like Instagram, TikTok, Facebook, or Twitter. These apps open links inside their own sandboxed SFSafariViewController or WKWebView, where iOS suppresses native Universal Link triggers to keep users inside their social feed.
Deeplio solves this with intelligent Anycast edge routing. When Deeplio detects an embedded social WebView, it serves an optimized edge response that allows users to seamlessly hand off to the native app or App Store listing without confusing error alerts.
Apple caches AASA files on its own CDN (app-site-association.cdn-apple.com). Deeplio ensures fast cache priming by serving appropriate Cache-Control headers directly from Cloudflare Anycast edge locations.
Universal Links Hosting: Deeplio vs Self-Hosted
Why Anycast edge workers provide the most reliable AASA delivery.
| Capability | Deeplio Edge | Alternative / Legacy |
|---|---|---|
| AASA Hosting Zero redirect compliance guaranteed | Automated Anycast hosting on custom domain | Manual server provisioning with exact MIME types |
| Social WebView Handling Protects paid and organic campaign conversion | Edge-detected platform routing & store fallbacks | Unhandled broken links inside Instagram/TikTok |
Key Implementation Checkpoints
- Add applinks:yourdomain.com to Xcode Associated Domains.
- Provide your Apple Team ID and Bundle ID to Deeplio.
- Rely on Deeplio edge workers to host AASA and route WebView fallbacks.
Ready to deploy branded Smart Links for your mobile app?
Automate your Apple AASA and Android Assetlinks endpoints on your own domain with fast Anycast edge routing. No client SDK required.
Frequently Asked Questions
Why does typing the URL into Safari address bar not open the app?
By design, Apple only triggers Universal Links when a link is clicked from an external webpage or app. Typing or pasting directly into Safari's address bar is interpreted as user intent to browse the website.
Does Deeplio require custom iOS SDKs?
No. Universal Links are an Apple operating system standard. Your app uses standard UIKit application(_:continue:restorationHandler:) or SwiftUI onOpenURL handlers.