Skip to main content

​
Deep Linking

Deep linking opens your mobile app directly when users click a link, providing a seamless experience.

​
How Deep Linking Works

  1. User clicks your Linquid short link on mobile
  2. Linquid detects the device (iOS/Android)
  3. The deep link is triggered to open your app
  4. If the app isn’t installed, the fallback URL is used
Enable deep linking on any link: 
{
  "deepLinkEnabled": true,
  "deepLinkIos": "yourapp://product/123",
  "deepLinkAndroid": "intent://product/123#Intent;scheme=yourapp;package=com.yourapp;end",
  "deepLinkFallbackUrl": "https://example.com/product/123"
}

​
On a Rule

Apply deep linking to specific conditions: 
{
  "type": "device",
  "conditions": { "os": ["ios"] },
  "destinationUrl": "https://apps.apple.com/app/id123",
  "deepLinkEnabled": true,
  "deepLinkIos": "yourapp://promo/summer",
  "deepLinkFallbackUrl": "https://example.com/promo"
}

​
URL Scheme

Basic URL scheme: 
yourapp://path/to/content
For Universal Links, configure your app’s Associated Domains and use your web URL: 
https://yourapp.com/product/123

​
Intent URL

Full intent syntax with fallback: 
intent://path/to/content#Intent;
  scheme=yourapp;
  package=com.yourapp.android;
  S.browser_fallback_url=https://example.com/fallback;
end
For App Links, use your verified web URL: 
https://yourapp.com/product/123
Use our helper to generate deep links: 
// iOS URL Scheme
generateDeepLink({
  platform: 'ios',
  scheme: 'yourapp',
  path: '/product/123',
  params: { ref: 'email' }
})
// → yourapp://product/123?ref=email

// Android Intent
generateDeepLink({
  platform: 'android',
  scheme: 'yourapp',
  package: 'com.yourapp',
  path: '/product/123'
})
// → intent://product/123#Intent;scheme=yourapp;package=com.yourapp;end

​
E-commerce

{
  "deepLinkIos": "shopapp://product/SKU123",
  "deepLinkAndroid": "intent://product/SKU123#Intent;scheme=shopapp;package=com.shop.app;end"
}

​
Social Media

{
  "deepLinkIos": "instagram://user?username=yourprofile",
  "deepLinkAndroid": "intent://user?username=yourprofile#Intent;scheme=instagram;package=com.instagram.android;end"
}

​
Streaming

{
  "deepLinkIos": "spotify://track/4iV5W9uYEdYUVa79Axb7Rh",
  "deepLinkAndroid": "intent://track/4iV5W9uYEdYUVa79Axb7Rh#Intent;scheme=spotify;package=com.spotify.music;end"
}

​
Fallback Behavior

When the app isn’t installed:
  1. iOS: Falls back to deepLinkFallbackUrl or App Store
  2. Android: Uses S.browser_fallback_url in intent or Google Play
Set a meaningful fallback URL that provides context about the app and includes an app store download link.
Test your deep links before deploying:
  1. Create a test link with deep linking enabled
  2. Click from a mobile device
  3. Verify the app opens to the correct screen
  4. Uninstall the app and verify fallback works