Custom short URLs on your own domain

Put your short links on your own domain, root or subdomain: verify it with a TXT record, connect it with A and AAAA, and the certificate is automatic.

On this page
  1. How custom short URLs on your own domain work
  2. Add your domain and verify it
  3. Connect it with A and AAAA records
  4. Set how links on your domain are named
  5. Choose fallback pages for broken or ended links
  6. Ask for a subdomain of brvl.app
  7. When a domain fails or your plan changes
  8. Common questions
  9. Next steps

A custom domain for short links gives you custom short URLs, with your own name on every link you share: go.example.com/spring instead of a shared address. You add the domain in Brevily, prove it's yours with one TXT record, and point it here with two address records. The certificate is issued and renewed for you.

People tap links they recognise, and a link on your own domain reads as yours on a poster, in a text or on a podcast.

Before you start: you need a domain whose DNS records you can change, and the Domains permission (see team roles and permissions). How many own domains you can add depends on your plan; see pricing.

How custom short URLs on your own domain work

  • Verify: a TXT record proves the domain is yours. It sends nobody anywhere.
  • Connect: an A and an AAAA record send the domain's visitors to your links. They work at a root domain (example.com) as well as a subdomain (go.example.com), at any DNS provider.

A name that serves your website can't serve links too, so use a subdomain such as go. beside it. Each domain's card shows three checks, Verified, Connected and Certificate, so you see what's missing.

Add your domain and verify it

  1. Open Link setup › Domains and choose Add domain.
  2. Type the Domain (no https://, no path) and a Label for your lists.
  3. Choose Add domain. The TXT · verifies tab shows the record, named _brevily-verify plus your domain, with copy buttons.
  4. Add that record wherever your DNS is managed, such as your registrar.
  5. Choose Check now. Not found yet? Give it a few minutes, then Check again.

[screenshot: the Add a domain dialog at step 2, with the TXT · verifies and A + AAAA · connect tabs]

No need to wait: the name is held for you for three days, and the domain's card has Check now too.

Connect it with A and AAAA records

The A + AAAA · connect tab, and the Connect panel on the domain's page, show two address records. Add both at the domain's own name and keep them while it serves links; the TXT record can go once verified.

The domain's page checks public DNS every few minutes and labels Connect:

  • Connected: visitors reach your links.
  • Not pointing here: no address yet, so most visitors can't open your links.
  • Points elsewhere: an old record still sends visitors somewhere else. Remove it.
  • Not checked: DNS couldn't be read; it's tried again shortly.

Behind a proxy, such as Cloudflare's? Set the records to DNS-only.

The certificate is automatic. It's issued once the address records point here, usually within the hour, and renewed for you. The domain's status then reads Serving. If issuing fails, the page says why and offers Try again.

The domain's Back-halves panel sets the rules for new links on it:

  • Length for new generated links: 3 to 12 characters. Once the domain has generated links, it can grow but never shrink.
  • How they are made: Random, Shuffled (looks random, never collides) or Sequential (easy to read, and as easy to guess).
  • A link may use the other generator: one link may pick a different style.
  • People may choose their own back-half: off, every link gets a generated one.

Choose Save changes. Changes apply to new links only.

When a link cannot be used sends visitors to your own pages instead:

  • The domain itself: someone opens go.example.com/ alone.
  • A back-half that does not exist: mistyped, or never made.
  • An expired link: past its date or click limit.
  • A disabled link goes to: a link its owner switched off.

Leave any blank for the standard page. Changes reach every region within about a minute. A link stopped for safety always shows the warning page.

[screenshot: a domain's page with the Connect panel and the When a link cannot be used panel]

Ask for a subdomain of brvl.app

No domain of your own? When Brevily offers it, Add domain has a second choice, A subdomain of brvl.app. Type the Subdomain, such as acme, and a Label, then choose Request subdomain.

There's nothing to set up in DNS: Brevily reviews each request and emails your organisation's owner either way. Once approved, acme.brvl.app is yours alone and counts as one of your plan's domains.

When a domain fails or your plan changes

The owner is emailed when a domain goes live. The owner and admins are emailed when a claim isn't proved within three days or a certificate fails, with what went wrong and how to fix it. Turn these off under Your account › Email me about › Domains.

Moving to a plan with fewer own domains? If the change is scheduled, every domain keeps working until the date Domains shows; before then, tick the ones to keep and choose Keep these; without a choice, the busiest stay. The rest are parked: their links show a neutral "not active" page, everything is kept, and a plan with room brings them back.

Common questions

Can I use my website's domain for short links?

Not the same name. Add a subdomain such as go.example.com for links, and the website stays as it is.

Why does my verified domain say Not connected?

The A and AAAA records aren't in place yet, or an old record points elsewhere. Add both from Connect.

Do I need an SSL certificate for my short link domain?

No. Brevily issues and renews it for you.

Next steps

All how-to guides

Brevily is invite-only, for now

Say what you would use it for and a person replies. Already invited? Sign in.