How to put your roadmap on a custom domain

By Hasan · November 5, 2026 · 5 min read

To put your roadmap on a custom domain, add the hostname in the Publish tab, then create two DNS records at your DNS provider. One is a TXT record that proves you own the domain. The other is a CNAME from the hostname to domains.justonecx.com. The status moves from pending to verified to active, and you can add up to 3 hostnames per workspace.

Why use your own hostname?

Every workspace already has a hosted page at boards.justonecx.com/<workspace-slug>/roadmap. It works with no setup. A custom hostname, such as roadmap.yourcompany.com, keeps customers on your own brand. The page uses your workspace Brand Kit, so colours and shape match.

If you also serve the boards on a custom domain, the pages tell search engines that the custom domain is the original. This avoids two copies competing in search.

If you have not built the roadmap yet, start with how to build a public product roadmap.

How do you add the hostname?

  1. Open Roadmap & Changelog > Publish > On your own subdomain.
  2. Add the hostname. You can add up to 3 per workspace.
  3. Choose which module the hostname shows, or the whole set.

The dashboard then shows the exact records you need to create. Use the values it shows, not values copied from an article.

Which DNS records do you need?

You create two records.

  1. A TXT record at _justonecx.<hostname> with the verification value from the dashboard. It proves you own the domain.
  2. A CNAME from the hostname to domains.justonecx.com.

For a hostname roadmap.yourcompany.com, the TXT record goes at _justonecx.roadmap.yourcompany.com.

A CNAME alone is not enough. Anyone can point a CNAME at us, so the TXT record is what proves ownership.

What if you use an apex domain?

An apex domain is the bare domain, such as yourcompany.com. An apex domain cannot hold a CNAME. For that case the dashboard shows an A record instead. Create the A record it shows. The TXT record is still required.

Most teams pick a subdomain such as roadmap. or changelog. because it keeps the main site separate.

What do the statuses mean?

After you save the records, wait. We re-check every 5 minutes. The status moves through these states.

Status Meaning
Pending verification TXT record not found yet.
Verified TXT found. We are getting the certificate.
Active HTTPS works. The page is live.
Failed A check failed. The dashboard shows why.

DNS changes can take a few minutes to spread. A status of pending right after you add the records is normal.

What should you check if the domain stays pending?

Work through this list.

  • The TXT record is at _justonecx.<hostname>, not at the hostname itself.
  • The TXT value matches the value in the dashboard exactly.
  • You did not add only a CNAME.
  • Enough time passed for DNS. We re-check every 5 minutes.

The same advice is on the troubleshooting page in the docs. If the status is Failed, the dashboard shows why.

How do you plan the change safely?

Pick the hostname first. Decide whether it shows only the roadmap, only the changelog or the whole set. Then create the records at the DNS provider that hosts your domain. If you do not manage DNS yourself, send the two record values from the dashboard to the person who does. Tell them the TXT record name is _justonecx.<hostname>, and that the CNAME target is domains.justonecx.com.

Keep the hosted address as a fallback while you wait. It works the whole time, so customers can still reach the roadmap during verification. Share the new hostname only after the status shows Active.

What happens after it is active?

The certificate is issued automatically and renewed for you. Active domains are re-checked daily. If a record disappears, the domain stops serving until you fix it.

If your plan drops below Scale, the custom domain stops serving. The hosted address keeps working, so customers still have a place to read the roadmap.

Does sign-on work on a custom domain?

Yes. Sign-on links work on your domain too. A visitor on a hosted page or custom domain is anonymous unless you link them with a sign-on link. Your server builds a short-lived signed link for the logged-in user, using your Secret key. The link expires after at most 10 minutes and works once. Use it to show a private board or to attribute votes to a customer. See the sign-on link guide.

The Secret key stays in your server environment as JUSTONECX_SECRET_KEY. Never put it in browser code.

Where else can the roadmap live?

A custom domain is one of three ways to show the same content. You can also embed the board in your own pages, or use the hosted page. Both are covered in the Roadmap, ideas and changelog guide. To tell customers when something ships, read how to write a changelog.

Frequently asked questions

How many custom hostnames can I add?

Up to 3 per workspace. You can choose which module each hostname shows, or the whole set.

Is a CNAME record enough?

No. The TXT record at _justonecx.<hostname> proves you own the domain. A CNAME alone is not enough.

Do I need to buy a certificate?

No. The certificate is issued automatically and renewed for you.

Can I use my root domain?

Yes. An apex domain cannot hold a CNAME, so the dashboard shows an A record for it.

See how it works in the live demo.

See it working in 2 minutes

Try the live demo

Related