Dynamic Links
Create smart links that route users to the right destination based on their device.
How Dynamic Links Work
A dynamic link is a single URL that behaves differently depending on how it is accessed. When someone clicks your link, LinkSense:
- Detects the user's device type and operating system
- Checks if the request is from a social media bot (serves preview metadata if so)
- Routes the user to the appropriate destination — app, app store, or web URL
- Records analytics data for the click
This means you can share a single link everywhere — social media, email, print materials — and each user gets the best experience for their device.
Creating a Link
To create a dynamic link, navigate to your project and click "New Link". Follow these steps:
Set the basic info
Give your link a name and optionally set a custom path. The name is for your reference only — it is not visible to end users.
Configure device routing
Set the destination URLs for iOS, Android, and desktop users. Each platform can have its own URL or fall back to a default.
Add social preview (optional)
Set a title, description, and image that appear when the link is shared on social media platforms.
Set a fallback URL
Choose a default URL for cases where no platform-specific routing matches (e.g., an uncommon operating system).
Save and share
Save the link and copy the generated URL. Your dynamic link is ready to use immediately.
Device Routing
Dynamic links support platform-specific routing. Each platform can be configured independently.
iOS
For iOS users, you can configure:
- Open in app — Route to your iOS app via Universal Links (requires registered iOS app)
- App Store link — Send users to the App Store if the app is not installed
- Custom URL — Send users to a specific web page
Android
For Android users, you can configure:
- Open in app — Route to your Android app via App Links (requires registered Android app)
- Play Store link — Send users to the Play Store if the app is not installed
- Custom URL — Send users to a specific web page
Desktop
Desktop users (Windows, macOS, Linux) are routed to the fallback URL by default. You can set a specific desktop URL if you want desktop users to go to a different destination than the fallback.
Custom Paths
Each dynamic link can have a custom path that makes it easy to recognize and share:
https://your-subdomain.linksense.net/summer-saleCustom paths must be unique within a project. They can contain lowercase letters, numbers, and hyphens. If you do not set a custom path, a random short code is generated automatically.
Reserved paths
Certain paths are reserved and cannot be used as custom paths. These include system paths like .well-known and other internal routes.
Fallback URLs
The fallback URL is used when no platform-specific route matches the user's device. It is also used as the default destination for desktop users unless a specific desktop URL is set. Every dynamic link should have a fallback URL configured.
Social Preview Settings
Each link can have custom social preview metadata. When a social media bot crawls your link, it receives an HTML page with Open Graph tags instead of being redirected. This allows platforms to display a rich preview card.
See the Social Previews page for detailed configuration guidelines and image recommendations.
Field Reference
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Internal name for the link (not visible to users) |
custom_path | string | No | Custom path slug (auto-generated if empty) |
fallback_url | url | Yes | Default destination URL |
ios_url | url | No | iOS-specific destination URL |
android_url | url | No | Android-specific destination URL |
desktop_url | url | No | Desktop-specific destination URL |
social_title | string | No | Title for social media preview cards |
social_description | string | No | Description for social media preview cards |
social_image_url | url | No | Image URL for social media preview cards |