Branded Link Domains
A branded link domain lets the links in your messages - click tracking, the email open pixel and shortened links - carry your own domain instead of the default Joryio domain. An organization can have one or more of them, so a workspace that runs several brands sends each brand's links on that brand's host.
Two kinds of domain
- Email links - carries the click links and the open pixel in email. Attach it to one or more of your sending email domains: email sent from those domains uses it.
- Short links - carries the shortened links in SMS, WhatsApp and Viber messages. Attach it to one or more of your sender numbers: texts sent from those numbers use it. Keep this one short, for example
l.brand.com, because every character counts in a text message.
One domain of each kind is the default: it serves every email domain or number that is not attached to another domain. A workspace with a single brand only needs the defaults.
Which subdomains to pick
Use subdomains of the domain you send from. If your email comes from brand.com, choose links.brand.com or track.brand.com for email links, and l.brand.com for short links. Spam filters compare the domains of the links in an email with the From address, and matching them helps your reputation. Do not use a root domain.
How it is set up
Joryio provisions the domains for you as part of onboarding, the same way sending domains and SMS or Viber senders are provisioned. Tell your Joryio contact which subdomains you want, which brand's email domains or numbers each one serves, and which connection model you prefer.
- Managed by Joryio (the default): you add a CNAME and the validation records Joryio sends you; Joryio's edge issues and renews the certificate. Nothing to run on your side.
- Customer-managed proxy: your own CDN or reverse proxy serves the hostname with your certificate and forwards every path to the Joryio origin shown on the settings page, query string included. Joryio checks the hostname every few minutes and activates it when the check answers. Choose this if your security policy requires you to own the TLS termination.
Your domains, their status, what each one serves and any records still to add appear under Settings → General → Branded Link Domains, with Copy buttons. Until a domain is active, its links keep using the default domain, so nothing breaks while DNS propagates.
Status reference
| Status | Meaning |
|---|---|
| Pending | Registered; waiting for your DNS records and certificate issuance, or for your proxy to answer. Links still use the default domain. |
| Active | Certificate issued, or proxy answering - the links it serves use this domain. |
| Failed | Validation did not complete, usually a missing or incorrect DNS record. Fix the record and ask Joryio to re-check. |
Changing or removing
Contact Joryio support to add a domain, attach it to other email domains or numbers, change the default, or remove it. Removing a domain reverts the links it served to the default at once.