Connect Your Own Domain

Give a site or the career site its own address, such as jobs.example.com: the DNS records, what each status and message means, and what the domain serves.

Setup Guide
Updated Nov 15, 20267 min readBy Sebastian Streiffert
For
A site in PagesSites, or the career site in Delivery.
Where
SettingsWorkspaceDomains for every domain, or the site's own Domain tab.
Who
The workspace owner, or someone with workspace settings access and the site's publish permission: Publish pages for a site, Manage Delivery for the career site.
Costs
Nothing. No credits.

A custom domain gives one site its own address, such as jobs.example.com, instead of a Lumenbase link. You keep the domain at the company you bought it from. You add two or three DNS records there, and Lumenbase does the rest, including the security certificate.

  1. Type the subdomain in the site's Domain card and click Connect.
  2. Add the DNS records the card shows at the company that hosts your DNS.
  3. Wait for Active. Click Check now to look again at once.

Connect a domain

Open the card in one of these places:

  • SettingsWorkspaceDomains: every domain in one table. Connect a domain asks which site, then shows its card. A row opens the card of its domain.
  • A site in Pages: PagesSitesyour siteDomain.
  • The career site: DeliveryJob postingsCareer siteDomain.

Type the address in Domain and click Connect. You can paste a full link: https://jobs.example.com/about becomes jobs.example.com. Lumenbase checks the DNS once right away, so the card shows which record is missing.

Which names work

  • A subdomain you own, such as jobs.example.com or events.example.com. A bare domain such as example.com does not work, and neither does example.co.uk.
  • Not an address of Lumenbase or its hosting, such as anything under lumenbase.io.
  • One domain per site, and a domain on one site only.

Add the DNS records

Add the records at the company that hosts your DNS: often the one you bought the domain from. Each name and value has a copy button. Changes can take up to an hour to show.

TypeNameValueWhat it does
TXT_lumenbase.jobs.example.comThe code on the card, one per domainProves you own the domain. Needed first. Once the domain is on our hosting, the card stops showing it.
CNAMEjobs.example.comThe address on the cardSends visitors to the site. The value comes from our hosting, so copy it from the card.
TXTAs the card shows itAs the card shows itOur hosting's own ownership check, when it asks for one.

jobs.example.com

Waiting for DNS

DNS records

Add these at the company that hosts your DNS. Changes can take up to an hour to show.
TXT
_lumenbase.jobs.example.com _lumenbase.jobs.example.com
3f9c2a7e5b1d4c8e9a6f0b2d7c4e1a95 3f9c2a7e5b1d4c8e9a6f0b2d7c4e1a95
Not found yet
Last checked 2 minutes ago
Just connected: the status is Waiting for DNS, the card says the TXT record is missing and lists it with its value

Next to each record the card says Found, Not found yet, Wrong value or Not checked.

jobs.example.com

Connecting

DNS records

Add these at the company that hosts your DNS. Changes can take up to an hour to show.
CNAME
jobs.example.com jobs.example.com
abc123xy.up.railway.app abc123xy.up.railway.app
Not found yet
TXT
_railway-verify.jobs.example.com _railway-verify.jobs.example.com
railway-verify=7d1e0c9b4a2f railway-verify=7d1e0c9b4a2f
Not found yet
Last checked 1 minute ago
Owned and on our hosting: the status is Connecting, the card asks for the CNAME and lists the records our hosting gave
If your DNS host can proxy traffic (an orange cloud, for example), turn that off for the CNAME. A proxied CNAME stops the security certificate from being issued.

What the status means

StatusMeaning
Waiting for DNS
The domain is not on our hosting yet. Usually Lumenbase is waiting for the TXT record that proves you own it.
Connecting
You own it. Lumenbase is waiting for the CNAME and the security certificate.
Active
The site answers on the domain. The card shows when it went live.
Failed
It stopped, or it will not work without a change from you. The card says why.

jobs.example.com

Active
Open site
Live since 3 days ago
Active: a link to the domain, when it went live, and Check now

How often Lumenbase checks

  • Waiting for DNS and Connecting: about every 15 minutes.
  • Active: about every 6 hours.
  • Failed: only when you click Check now. A check that finds everything in place makes it Active again.

A domain becomes Failed when:

  • It is still not Active 7 days after you connected it.
  • It was Active and 4 checks in a row did not find it working. It keeps serving the site until then.
  • It is a bare domain, the certificate could not be issued, or our hosting has no room for another domain. These do not fix themselves.

When a domain becomes Failed, the workspace gets one System Notification, "jobs.example.com stopped working". It goes away when the domain is Active again.

Every message the card can show

The card shows the reason from the last check in a warning at the top. Each message starts with the words below and goes on to say what to do.

MessageWhat to do
The TXT record is missing.Add the TXT record at _lumenbase.your-domain with the value on the card, then Check now.
The TXT record has another value.Replace the value with the one on the card. Each domain has its own.
The CNAME record is missing.Add the CNAME with the value on the card.
The CNAME record points to (the address it points to now).Change the CNAME to the value on the card.
Bare domains are not supported.Remove the domain and connect a subdomain such as jobs.example.com.
The DNS records could not be read just now.Nothing is wrong with your records. Check again in a minute.
Our hosting has not seen the DNS records yet.Check that the records match the card. They can take up to an hour to show.
The security certificate is being issued.Wait. This usually takes a few minutes.
The security certificate could not be issued.Turn off any proxy on the CNAME, then Check now.
Our hosting refused this domain.Remove it and connect it again. If that does not help, contact support.
Our hosting has no room for another custom domain.Contact support.
Our hosting did not answer.Check again in a minute.
Custom domains are not set up on this Lumenbase environment yet.Contact support.
The site this domain belongs to is gone.Remove the domain.
The site is not published, so the domain shows nothing yet.Publish the site. The domain can still be connected first.

When you type the domain

MessageWhat to do
Enter a domain name such as jobs.example.com, without https:// or a path.Type only the name.
Use a subdomain such as jobs.example.com. Bare domains are not supported yet.Add a part in front, such as jobs.
That address belongs to Lumenbase or its hosting and cannot be connected.Use a domain you own.

When you click Connect

These follow "The domain could not be saved:".

MessageWhat to do
This site already has a domain. Remove it first to connect another.Remove the old domain from the card's ... menu.
That domain is already connected to a site.Remove it from the other site first, in Settings, Workspace, Domains.
A workspace can connect up to 10 domains. Remove one to add another.Remove a domain you no longer use.
You need workspace settings access and "Publish pages" to connect a domain to this site.Ask the owner, or someone who has both.
You need workspace settings access and "Manage Delivery" to connect a domain to the career site.Ask the owner, or someone who has both.

Someone without those permissions still sees the card and its status, with You can see this domain. Changing it needs workspace settings access and the site's publish permission.

What visitors get on the domain

The domain serves the site and nothing else:

AddressWhat it shows
/The site's home page
/page-addressA page of the site
/jobsThe job list. Career site only, while recruiting is on
/jobs/job-addressOne job and its application form. Career site only
/accountThe candidate account. Career site only
/robots.txt, /sitemap.xmlFor search engines: a published site lists its public pages and, for the career site, its open jobs

Every other address answers as not found. The Lumenbase app, its sign-in and other workspaces never answer on your domain.

Once the domain is Active and the site is published, the Lumenbase addresses of its pages send visitors to the same page on your domain. This covers /p/your-workspace/page, /jobs/your-workspace and /jobs/your-workspace/job, so links you already shared keep working.

Removing a domain

Remove domain is in the card's ... menu. The site stops answering on that address at once. Its Lumenbase address keeps working.

Limits

  • Up to 10 domains per workspace. Removed ones do not count.
  • One domain per site.
  • Subdomains only. A bare domain such as example.com cannot be connected.
  • A domain shows one site. A single page outside a site cannot have a domain: put it in a site first.
  • Email sending domains are separate. They live under SettingsWorkspaceEmailSending domains.

Troubleshooting

It stays on Waiting for DNS

  1. Check the TXT name. Many DNS hosts add your domain to the name for you. If the name ends up doubled, enter only _lumenbase.jobs.
  2. Check the value is the code on the card, with nothing added.
  3. Wait up to an hour, then click Check now.

It stays on Connecting

  1. Check the CNAME points to the value on the card, which can differ from the one shown before the domain was owned.
  2. Add our hosting's TXT record if the card lists one.
  3. Turn off any proxy on the CNAME.

Active, but the domain shows nothing

Publish the site. A draft or archived site shows nothing on its domain. Check also that the page itself is published.

I cannot connect a domain

The Connect button needs workspace settings access and the site's publish permission. Domains in Settings is only for people with workspace settings access.

Every domain
SettingsWorkspaceDomains
Ownership record
TXT _lumenbase.your-domain
Career site
Your career site
Sites and pages
Pages

Frequently asked questions

Which DNS records does a custom domain need?

A TXT record at _lumenbase.<your domain> with the code on the card, which proves you own it, and a CNAME from your domain to the address the card shows. If our hosting asks for its own TXT record, the card lists that too.

Can I connect example.com without a subdomain?

No. Bare domains are not supported. Use a subdomain such as jobs.example.com or events.example.com.

What happens to the old links when I connect a domain?

Once the domain is Active and the site is published, the Lumenbase addresses of the site's pages and jobs send visitors to the same page on your domain. Removing the domain stops it at once, and the Lumenbase address works again.

How many custom domains can a workspace have?

Up to 10, one per site. Removed domains do not count.

Was this article helpful?