Link management
Create, organize, and maintain branded short links with slugs, expiration, passwords, and metadata.
Links are the core resource in Public Url. Each link maps a short URL on a domain you control to a destination URL, with optional targeting, metadata, and lifecycle rules.
Create a link
Every link needs a destination URL. Everything else is optional:
| Option | Notes |
|---|---|
| Custom slug | Human-readable path segment. Unique per domain. |
| Domain | The workspace default domain or any verified branded domain. |
| Redirect type | 302 (default) for trackable links; 301/307/308 when you need it. |
| Expiration | Expire at a fixed date; visitors see a fallback afterwards. |
| Password | Gate the destination behind a password prompt. |
| Tags, folders, projects | Organize links for filtering and reporting. |
| Campaign | Attribute the link to a campaign with UTM parameters. |
Destinations stay editable after creation — fix typos or repoint a campaign without changing the short URL that is already in circulation.
Social previews and metadata
Each link can carry its own Open Graph title, description, image, and author. These power unfurls in Slack, X, iMessage, and other crawlers, and dynamic OG images can be generated per link.
QR codes
Every link has a downloadable, customizable QR code. QR scans resolve through the same redirect pipeline, so they appear in analytics like any other click.
Bulk import
Use Bulk import on the Links page to create many links from a CSV file:
name,destinationUrl,slug,status
Docs,https://example.com/docs,docs,active
Pricing,https://example.com/pricing,,activeRows without a slug get an auto-generated one. The importer validates URLs and slug uniqueness per domain before creating anything.
Link previews
The API exposes an unfurl preview endpoint (GET /v1/links/preview?url=...)
that fetches a destination's title, description, and image — useful for
showing what a link points at before you create it.
Lifecycle
Links can be active, expired, or archived. Archiving removes the link from redirect resolution without deleting its analytics history, so past campaign reports stay intact.