VoyseDocumentation

Connect your domain

By default your site is served from a Voyse address. A Custom domain serves it from yours instead — careers.yourcompany.com — which is what candidates expect and what your marketing team will ask for.

This is the one step you can't finish alone: someone with access to your DNS records has to add entries. Have them to hand, or book ten minutes with them, before you start.

What happens

Voyse needs to prove to the internet that the domain is yours, then serve it securely. That means two rounds of DNS records rather than one, and a wait between them.

  1. In Settings, under Custom domain, enter the address you want.
  2. Voyse requests a certificate for it. You'll see Requesting the certificate and preparing the edge… — this can take a moment.
  3. Required DNS records appears. Add every record shown at your DNS provider, exactly as given. Each row says its Purpose, so you can tell your DNS administrator what they're for.
  4. Come back and check the status. Until the records are visible you'll keep being told to add them.
  5. Once the certificate is validated, Voyse creates the edge that serves your site, then shows you a CloudFront CNAME — a single address your domain needs to point at. Add that as your final record.
  6. When that resolves, your site is live on your domain.

Nothing about your site changes in the process — the same pages, jobs and templates, at a new address.

If it didn't work

  • You're still being asked to add the records. DNS changes take time to propagate; your provider may say minutes and mean an hour. Confirm the records match exactly, including any trailing dot your provider adds, then wait and check again.
  • We couldn’t request the certificate or We couldn’t create the CloudFront distribution — the attempt failed rather than your records being wrong. Try again shortly; if it keeps failing, tell us.
  • The last attempt did not complete. Same: start the check again.
  • The domain works but the site doesn't look right. That's not a domain problem — check the page and template it's serving.

If your domain is already serving another site, decide what happens to it before you point the record: the switch is immediate for anyone whose DNS has caught up.