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.
- 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.
- Type the subdomain in the site's Domain card and click Connect.
- Add the DNS records the card shows at the company that hosts your DNS.
- 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.comorevents.example.com. A bare domain such asexample.comdoes not work, and neither doesexample.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.
| Type | Name | Value | What it does |
|---|---|---|---|
| TXT | _lumenbase.jobs.example.com | The code on the card, one per domain | Proves you own the domain. Needed first. Once the domain is on our hosting, the card stops showing it. |
| CNAME | jobs.example.com | The address on the card | Sends visitors to the site. The value comes from our hosting, so copy it from the card. |
| TXT | As the card shows it | As the card shows it | Our hosting's own ownership check, when it asks for one. |
jobs.example.com
DNS records
Add these at the company that hosts your DNS. Changes can take up to an hour to show._lumenbase.jobs.example.com _lumenbase.jobs.example.com3f9c2a7e5b1d4c8e9a6f0b2d7c4e1a95 3f9c2a7e5b1d4c8e9a6f0b2d7c4e1a95Next to each record the card says Found, Not found yet, Wrong value or Not checked.
jobs.example.com
DNS records
Add these at the company that hosts your DNS. Changes can take up to an hour to show.jobs.example.com jobs.example.comabc123xy.up.railway.app abc123xy.up.railway.app_railway-verify.jobs.example.com _railway-verify.jobs.example.comrailway-verify=7d1e0c9b4a2f railway-verify=7d1e0c9b4a2fWhat the status means
| Status | Meaning |
|---|---|
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. |
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.
| Message | What 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
| Message | What 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:".
| Message | What 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:
| Address | What it shows |
|---|---|
/ | The site's home page |
/page-address | A page of the site |
/jobs | The job list. Career site only, while recruiting is on |
/jobs/job-address | One job and its application form. Career site only |
/account | The candidate account. Career site only |
/robots.txt, /sitemap.xml | For 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.
Old links move to the 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
- 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.
- Check the value is the code on the card, with nothing added.
- Wait up to an hour, then click Check now.
It stays on Connecting
- Check the CNAME points to the value on the card, which can differ from the one shown before the domain was owned.
- Add our hosting's TXT record if the card lists one.
- 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?
