Create a Dynamic Link
LimeLink includes a free dynamic link generator for Project default-domain URLs. Use the editor to configure app, store, and browser destinations without building a routing service yourself. Pro is required only when creating new Custom Domains or Custom Domain Links.
Open a Project, select Links, then select Create Link.
Example Configuration
A basic product Link might use:
| Field | Example |
|---|---|
| Name | Spring product campaign |
| Destination URL | https://example.com/products/spring |
| Suffix | Leave empty for server generation, or enter an available value |
| Apple behavior | Open an iOS Application, otherwise App Store |
| Android behavior | Open an Android Application, otherwise app store |
| Browser fallback | Destination URL |
Use non-secret placeholder values in documentation and automation. Never put an Organization API key in browser or mobile code.
1. Choose a Link Domain
Under Link domain, choose LimeLink default domain or an ancestry-valid Custom Domain whose lifecycle is Active.
- Default-domain creation remains available without Pro.
- Creating a Custom Domain Link requires both an Active Domain and an active Pro subscription for the Project.
- A pending, failed, expired, or deleting Domain cannot be selected.
- If billing cannot be verified, LimeLink blocks Custom Domain Link submission and offers Retry rather than assuming entitlement.
2. Enter Link Details
Complete Name and Destination URL. Suffix may be left empty during link generation and is then generated by the server. A manually selected suffix must still be available when saved; an earlier availability result does not reserve it.
Select Enable stats association only when the Link should participate in stats collection.
3. Configure Platform Options
Enable Apple options or Android options as needed. For Open behavior, choose Open browser or Open app.
- Open app requires the one active Application for the matching Project/platform.
- Request URI identifies the app destination expected by that Application.
- When app is not installed can route to App store or Custom URL.
- Platform association still requires iOS Associated Domains or verified Android App Links in the app.
Follow the SDK integration guide before testing installed-app or deferred behavior.
4. Configure Additional Options
Under Additional options, optionally enable Social preview and enter Preview title, Preview description, or Preview image URL. Optionally enable UTM parameters and enter Source, Medium, or Campaign. Skip app preview is independent of those groups.
See Link Preview for the boundary between Link preview fields, UTM parameters, and the Project logo.
5. Save and Verify
Select Save Link, then verify:
- Link detail loads without a tenant or relationship error.
- Short URL becomes non-null and Ready becomes Yes before copying it.
- A desktop/browser test reaches the configured destination.
- iOS and Android tests exercise installed, not-installed, and fallback paths that you configured.
- An eligible deferred test starts before installation and verifies the destination after first launch.
In a blocked Organization, the editor displays “This Organization is blocked. Link settings are read only.” and disables Save Link. Existing ready Links remain readable and copyable; blocked status prevents Link mutations, not clipboard copy.
If suffix, Domain, Application, entitlement, or tenant state changed during editing, refresh the relevant data and try again. A short_url of null means the Link is not ready to copy.
Automate Link Generation
For trusted server automation, use the public API integration guide. The API supports Core Link creation, suffix availability, Project/default-domain and Custom Domain Link operations, and canonical URL resolution. Keep X-API-KEY credentials server-side.
For AI-assisted workflows, the MCP server exposes a documented create-link tool. Terraform intentionally does not manage Links; it can inspect an existing Link by UUID through the read-only data.limelink_link data source.