Skip to content
Custom Domains

Custom Domains

Availability: Custom domains are available on Starter and higher, with higher domain limits on Professional and Agency.

By default your short links use Shortn’s domain, shtnl.ink. With a custom domain, they use your own — for example https://link.yourbrand.com/abC12x9. Manage domains from Domains in the dashboard.

Custom domains require the Starter plan or above. See plans for how many domains each plan allows (Starter 3, Professional 10, Agency 50).

Add a domain

  1. Go to Domains and select Add New Domain.
  2. Enter a root domain (yourbrand.com) or a subdomain (link.yourbrand.com). A subdomain is usually safer: pointing a root domain at Shortn can interfere with your website or email records, so Shortn asks you to confirm.
  3. Shortn shows the DNS records to create at your DNS provider.
  4. After the records are in place, select Run verification.
  5. Shortn provisions an SSL certificate automatically.

DNS records

Shortn shows the exact records for each domain under DNS settings. In general you’ll configure:

  • TXT record (to prove ownership) — host _shortn-verify.<your-domain> with the value shortn-domain-verification=<token> Shortn gives you.
  • CNAME record (for subdomains, e.g. link.yourbrand.com) — point your domain at the Shortn edge host shown in the dashboard.
  • A records (for root/apex domains, e.g. yourbrand.com) — point your apex at the IP addresses Shortn lists.

Use the records exactly as shown for your domain — the values are specific to it. Each record shows whether it matched, and the values Shortn detected.

SSL

Once DNS verifies, Shortn provisions SSL automatically. The certificate goes through a staging check and then a production certificate, and the domain is ready when HTTPS is confirmed. You don’t need to obtain or renew certificates yourself.

Domain status

A domain is ready once it’s verified, SSL is enabled, and provisioning is complete. While it’s being set up you may see pending states (DNS, TLS, ingress). If something goes wrong, the domain shows an error with details to fix.

Keeping a domain verified

Shortn checks a ready domain’s DNS records every hour, and again whenever you verify it. One failed check doesn’t turn the domain off: it shows DNS check failing with the error, and keeps working. If 3 checks in a row fail, the domain is turned off: its links stop working, its certificate is removed, and you get a notification. Fix the DNS records and verify the domain again to bring it back.

Who can use a domain

A domain belongs to the person who added it, and counts toward that person’s plan. Under Permissions, choose the workspaces it’s available in:

  • Workspace access lists the workspaces both you and the domain’s owner belong to. The owner can assign any of them; a workspace owner or administrator can change only the workspaces they administer.
  • Team access: in each workspace, leave Everyone in this workspace on, or turn it off and pick the teams that can use the domain. Only workspace owners and administrators can change team access.

A workspace stays assigned while links in it use the domain: move those links to another domain or workspace first.

Transfer a domain

The domain’s owner can Transfer it to another person. The new owner must be an active member of every workspace the domain is assigned to, and their plan must have room for another custom domain; anyone who can’t receive it is shown greyed out with the reason. After the transfer, the domain counts toward the new owner’s plan, and its workspace assignments, DNS verification and certificate stay as they were.

Delete a domain

Only the domain’s owner can delete it. A domain can’t be deleted while any link uses it, including suspended and archived links: delete those links or move them to another domain first. To delete several domains, select them and choose Delete selected; domains that can’t be deleted are skipped, with the reason.

Use a domain on a link

When you create or edit a link, pick the domain from the short domain selector. New links start on the workspace’s Default domain, which workspace owners and administrators set in the workspace’s settings; without one, the platform domain is used. Existing links keep their domain when the default changes.

From Domains, Manage links opens the links that use a domain (including non-active ones), and Create first link starts a new link on it.

Last updated on