Before you start
- You need the Standard plan or above. During a Standard trial you can add the domain and check its records, and you switch it on once you've upgraded in Plan & billing.
- Pick a subdomain you don't use yet, such as people.yourcompany.com or hr.yourcompany.com, not your main website address. Your website and email stay exactly as they are.
- Find out where your domain's DNS is managed: usually where you bought the domain (such as GoDaddy or 123-reg), sometimes Cloudflare or your web designer. You'll need to sign in there, or send them the records.
Steps
- Open Settings and choose Sign-in & domain. Under Custom domain, enter your subdomain and choose Add domain.
- Where you manage your domain's DNS, add each record the page shows: a CNAME record, and a TXT record if one is listed. Use the copy buttons beside Name / host and Value, and paste them exactly as they are, except where your host is in Notes for common DNS hosts below.
- Back in HollyHR, choose Check DNS. When every record says Detected and the status is Ready to activate, choose Activate.
New records usually show within an hour, sometimes up to 48 hours. HollyHR checks when you choose Check DNS, and Last checked shows when it last looked, so come back and check again later if a record still says Required.
What changes for your team
- Everyone can sign in at your address, such as people.yourcompany.com. There they sign in with a link we email them.
- Links in HollyHR emails, such as invitations, reminders and approvals, take people to your address.
- Your HollyHR address (yourcompany.hollyhr.com) keeps working, so old bookmarks and links still reach your workspace. Use it to sign in with Google or Microsoft, or to switch between HollyHR workspaces: those stay on HollyHR addresses.
The records to add
After you choose Add domain, each record shows on the page with its type, Name / host and Value, and a copy button for each. Copy them from there: the values are made for your domain.
- CNAME, with a name such as “people” and the value “domains.hollyhr.com”. It points your subdomain at HollyHR.
- TXT, when one is listed, with a name such as “_vercel.people”. It proves the domain is yours. Add it exactly as shown.
- If you use your root domain (yourcompany.com) instead of a subdomain, the page shows an A record with the name “@” instead of the CNAME. We don't recommend it: it would replace your website.
Notes for common DNS hosts
Only what differs from the steps above. Menus change from time to time; if yours look different, search your host's help for “add a CNAME record”.
- Cloudflare: DNS › Records › Add record. Name: paste Name / host. Turn Proxy status off so it says DNS only (grey cloud). With the orange cloud on, the domain won't verify.
- GoDaddy: Domain Portfolio › your domain › DNS › Add New Record. Paste Name / host as it is (such as “people” or “_vercel.people”): GoDaddy adds your domain itself.
- 123-reg: Control Panel › your domain › DNS › Add New Record. If 123-reg won't save the CNAME, or it isn't detected, enter its value with a full stop at the end: “domains.hollyhr.com.”. Paste the TXT value exactly as shown, with no dot. New records can take 24 to 48 hours.
- IONOS: Domains & SSL › your domain › DNS › Add record. If it asks, create the subdomain (such as “people”) first. Don't add “http://” or a full stop to the value.
- Namecheap: Domain List › Manage › Advanced DNS › Add New Record. Host: paste Name / host, then Save All Changes. If a record with that host is already there (such as a URL Redirect), check what it's for before you delete it; if it's in use, pick another subdomain.
- Squarespace (including domains that were with Google Domains): Domains › your domain › DNS › DNS Settings › Custom records › Add record. If your domain is connected to Squarespace but its DNS is managed by another provider, add the records at that provider instead.
What each status means
- Requested or Pending DNS: we haven't found your records yet. Add them, wait a little, then choose Check DNS.
- Required or Detected beside a record: whether we found that record at the last check.
- Verified (Ready to activate): every record is in place. Choose Activate.
- Active: your team can sign in at your address, and emails link to it.
- Disabled: your address is switched off and your team signs in at your HollyHR address. To use it again, choose Check DNS, then Activate. If it says cleanup is still finishing, try again in a few minutes.
Change your HollyHR sign-in address
Under Sign-in address on the same page, type the new address and choose Save changes. HollyHR asks you to confirm it's you, then takes you to the new address to sign in again. Tell your team the new address. For 90 days the old one sends people to the new one, no one else can take it, and you can change back to it.
What happens next
Once it's Active, your address works within a few minutes, while its security certificate is set up: open it yourself before you tell your team. HollyHR emails link to it. To stop using it, choose Disable: your team goes back to your HollyHR address and you can switch it on again later. To get rid of it, choose Remove, then delete its records at your DNS host. If you move to a plan without custom domains, the domain is switched off and your team signs in at your HollyHR address. Once it's off, links and bookmarks to your address stop working and new emails use your HollyHR address, so tell your team.
If something goes wrong
A record still says Required. Give it an hour and choose Check DNS again. Check the record's type, and copy its Name / host and Value again from that record's row on the page: the CNAME and TXT names differ. If your host shows the name with your domain twice (people.yourcompany.com.yourcompany.com), you pasted the full name: use Name / host instead. On 123-reg, see its note above.
Your host won't let you add the CNAME. A name can have only one CNAME and nothing else beside it, so a record with that name is already there. It may be in use: choose a different subdomain, or check with whoever set it up before you delete it.
It's on Cloudflare and won't verify. Edit the CNAME and set Proxy status to DNS only (grey cloud).
The records are detected but the address shows a security warning. Your domain may have CAA records, which limit who can issue its security certificate. Ask whoever manages your DNS to add a CAA record that allows Let's Encrypt (0 issue letsencrypt.org), then wait an hour and check again.
It says the domain is already used. Another HollyHR workspace, or another service, is using it. If you removed it from your own workspace a moment ago, wait a few minutes and try again. If it's connected to an old website or app, remove it there first, or use a different subdomain. Still stuck: contact support.
Activate is greyed out. Every record has to say Detected first. During a trial, upgrade in Plan & billing to switch it on.