Link domains

Every workspace gets its own link domain, .strait.link. That's what lets your links open your app, and only your app.

On this page 4
  1. Why your own subdomain
  2. Slugs belong to your workspace
  3. Your handle
  4. Custom domains
THIS PAGE · THE DOMAIN PART · SAMPLE

YOUR WORKSPACE DOMAINlive

hilltop.strait.link

the screen it opens

/trail-runner

what it opens with

?size=9

go.hilltop.example Your own domain: live

Why your own subdomain

Android App Links and iPhone Universal Links are verified per domain. The phone downloads a small file from the link's domain that says which app may open its links:

  • https://hilltop.strait.link/.well-known/assetlinks.json (Android)
  • https://hilltop.strait.link/.well-known/apple-app-site-association (iPhone)

If every customer shared one domain, that file could only name one app, and everyone else's links would open the browser. So each workspace gets its own subdomain, and we serve your app's files from it, built from the details in Dashboard → Apps & stores.

Slugs belong to your workspace

A slug is unique within your workspace, not across Strait. Two workspaces can both have /summer: https://hilltop.strait.link/summer and https://oaklane.strait.link/summer are different links that open different apps.

That's why you should always share your handle URL, never the bare https://strait.link/summer. The bare strait.link root only answers a slug that no other workspace uses, so links shared before workspaces had their own domains keep working. Once a second workspace creates the same slug, the bare address finds nothing. The API returns the right address for every link as shortUrl, and the dashboard copies it for you.

Your handle

Your handle comes from your workspace name when you sign up (for example "Hilltop Shoes" becomes hilltop-shoes). Handles are 3 to 30 characters: lowercase letters, digits and hyphens. Some words, like www, api and status, are reserved for our own use.

Use your link domain in three places:

  1. The SDK endpoint: https://hilltop.strait.link
  2. Android: the android:host of your App Links intent filter
  3. iPhone: the Associated Domains entry applinks:hilltop.strait.link

Custom domains

On Starter and up you can also put your links on a subdomain you own, such as links.yourcompany.com: one CNAME and two TXT records, and we issue the HTTPS certificate and serve your app's files on it. Your <handle>.strait.link keeps working alongside it. Step by step: Custom domains.