Deep Linking Guides
Practical guides for when deep linking breaks in production, from the AASA file to in-app browsers.
What Is Deep Linking? How Mobile Deep Links Work on iOS and Android
Deep linking uses a URL to open a specific app screen. See how Universal Links, App Links, and deferred deep links work on iOS and Android, with setup steps.
25 min readDeep Link vs Deferred Deep Link: Which One Do You Need?
Deep link vs deferred deep link: one opens an installed app on the right screen, the other carries the link through the install. Which you need, with code.
8 min readReact Native Deep Linking: Universal Links and App Links Setup Guide
React Native deep linking takes three pieces: Universal Links on iOS, App Links on Android, and a React Navigation linking config. Set each one up end to end.
25 min readFlutter Deep Linking: Universal Links, App Links and Cold Start Setup
Flutter deep linking in nine steps: Associated Domains, an autoVerify intent filter, Flutter's link flag off, and a cold start that waits for the navigator.
26 min readUniversal Links Not Working? 15 Causes and the Fix for Each
Universal Links not working or opening Safari? Fifteen causes in order, from address-bar tests to AASA files and handlers, each with the check and the fix.
13 min readUniversal Links Open Safari? Fix Your apple-app-site-association File
Universal Links opening Safari? Run curl -sI on the AASA file, compare Apple's CDN copy, then fix appIDs, paths and entitlements. Seven steps, one check each.
19 min readAndroid App Links autoVerify Failed? 12 Causes and Fixes
autoVerify failed and links open the browser or a chooser? Check assetlinks.json with curl, then pm get-app-links on the device. 12 causes, each with a fix.
16 min read10 Deep Linking Mistakes That Break Install Attribution
Installs showing as unattributed? Ten deep linking mistakes that stop an install from matching its link, each with the symptom, the check, and the fix.
9 min readHow to Test Deep Links: simctl and adb Commands, Plus a Pre-Launch Checklist
Test deep links on iOS and Android with xcrun simctl and adb, verify Universal Link and App Link state, then run a pre-launch checklist and Maestro CI recipe.
25 min readSet Up Deep Linking With Claude Code: From Empty Project to Verified Link
Connect Claude Code to the WarpLink MCP server and let it register your app, add the SDK, create a link, and run verify_setup. Commands and outputs inside.
10 min readDeep Links in Instagram and Facebook In-App Browsers: The Fixes
A deep link tapped in the Instagram, Facebook, or TikTok in-app browser usually will not open your app. What each one does on iOS and Android, and the fixes.
20 min readEmail Deep Linking: Why Tracked Links Open the Browser, Not Your App
Email click tracking rewrites links to a tracking domain, so Universal Links never fire. See the mechanism, three fixes, and provider support.
21 min readQR Codes That Open Your App, Not the Store Page
A scan opens your app only when the QR code encodes an HTTPS redirect you control. Set up per-platform routing, install handoff and tracking per placement.
22 min readHow to Pass UTM Parameters Through Deep Links Into Your App
How to pass UTM parameters through deep links: where the query string survives, where it dies, how to read them on iOS and Android, and how to report them.
22 min readOne Link for Both App Stores: How to Route iOS and Android Users
One link for both app stores: send iPhone to the App Store, Android to Google Play, desktop to your site, and installed users into the app.
23 min readDeferred Deep Linking in Expo: Setup and Testing
Expo deferred deep linking in the managed workflow: install, app.json, a development build, the first-launch onLink match, and how to test a real install.
25 min read
Deep linking looks simple until a Universal Link opens Safari instead of the app, an Android intent filter refuses to autoverify, or a QR code drops a reader on the App Store with no way back to the page they scanned for. This collection walks through the mechanics that make deep linking reliable in production: the apple-app-site-association file, Android App Links verification, the in-app browser quirks inside Instagram and TikTok, passing UTM parameters through a link, and how to test a deep link on a real device before it ships. Each guide is a practical walkthrough for a developer debugging one specific failure. WarpLink is link infrastructure for mobile teams: deep linking, install attribution, and real-time analytics in one SDK, and every link these guides describe already carries attribution and click data by default. Start with the guide that matches the platform or symptom you are hitting today.
Deep Linking