Use your own domain for customer links
Open quote and invoice links on a subdomain you own, such as billing.yourcompany.com.
Your customers open quotes and invoices from a link. By default it starts with app.liteo.io. Connect a subdomain you own and new links start with that instead, for example https://billing.yourcompany.com/p/....
What changes
Only the customer link changes. That's the page where your customer reads a quote or invoice, answers a quote, and downloads the PDF.
These stay the same:
- Your team's Liteo. You and your team keep signing in at
app.liteo.io. - Email. The domain has nothing to do with sending. To send from your own address, connect your mailbox in Settings, then Email.
- Everything else on the subdomain. Liteo serves the customer link there and nothing else. Any other address on it shows a "Not found" page.
Before you start
You need:
- admin access to your Liteo workspace;
- a paid plan (custom domains aren't available during the trial);
- access to the DNS settings for your domain.
Each workspace can connect 1 domain. It has to be a subdomain, such as billing.yourcompany.com. Your main domain, yourcompany.com, can't be used, so your website is never affected.
Connect your domain
- In Liteo, open Settings, then choose Custom domain under CRM setup.
- Enter your subdomain, for example
billing.yourcompany.com. - Select Connect.
Liteo then shows the DNS records to add, each with a copy button.
Add the DNS records
Add every record exactly as the page shows it, where you manage your domain's DNS. That's usually your domain registrar or a DNS service such as Cloudflare.
| Type | Name | Value |
|---|---|---|
| CNAME | billing.yourcompany.com | domains.liteo.io |
| TXT | _liteo-verify.billing.yourcompany.com | liteo-verify= followed by your own code |
The TXT record proves the domain is yours. The CNAME record points it at Liteo. Copy the TXT value from the page. It's different for every workspace.
Some DNS providers add your domain to the name for you. If yours does, enter only the first part, such as billing or _liteo-verify.billing.
Sometimes the page asks for a second TXT record. That happens when the domain was used on another website before. Add it the same way.
If your DNS is on Cloudflare
Set the CNAME record to DNS only (the grey cloud). A proxied record, with the orange cloud, hides where the domain points, and the connection can't finish.
If your domain has CAA records
CAA records limit which companies can issue security certificates for your domain. If your domain has any, add one that allows Let's Encrypt, for example 0 issue "letsencrypt.org". Without it, the secure connection never becomes ready.
How long it takes
You don't need to keep the page open. Liteo checks on its own: every 30 seconds for the first hour, then every 10 minutes. The page updates as each step passes:
- Ownership record found
- Domain points to Liteo
- Secure connection ready
DNS changes can take up to a day to show. Select Check now after you've fixed a record.
Liteo stops checking after 3 days. Select Check now to start again.
When all 3 steps pass, the page says Customer links use your domain and shows a sample link. Links you create or send from then on use your domain.
Fix a problem
While Liteo waits, the page says what it found. Here's what each message means.
| Message | What to do |
|---|---|
| Liteo hasn't found the TXT record yet. | Check the TXT record's name and value. If they're right, give DNS more time. |
| The CNAME record doesn't point to domains.liteo.io yet. | Check the CNAME record. On Cloudflare, set it to DNS only. |
| Add the second TXT record shown below, then check again. | Add the extra TXT record from the page, then select Check now. |
| The secure connection isn't ready yet. | Wait. It usually takes a few minutes once the CNAME record is in place. |
| The secure connection still isn't ready. | Make sure the CNAME record isn't proxied and no CAA record blocks Let's Encrypt. |
| This domain is connected to another website host. | Remove the domain from that host, then select Check now. |
| Another Liteo workspace already uses this domain. | Use a different subdomain. |
| This domain can't be connected. | Use a different subdomain. |
| Liteo can't reach your domain. | Check that the CNAME record still points to domains.liteo.io. |
| Liteo couldn't finish setting up the domain. | Nothing to do. Liteo tries again shortly. |
If your domain stops working
Once connected, Liteo checks your domain every day. If 3 daily checks fail in a row, the domain shows needs attention and the page names the problem.
While it needs attention, new links use app.liteo.io. Links already sent on your domain keep loading as long as the domain still points to Liteo. Fix the record and select Check now. Liteo also keeps checking every day, so the domain reconnects on its own once the record is right again.
Disconnect your domain
- Open Settings, then Custom domain.
- Select Disconnect, then confirm.
New links go back to app.liteo.io straight away.
Links you already sent on your domain stop working. To give a customer a working link, send the document again. It goes out on app.liteo.io.
While the domain is still waiting to connect, the button is called Remove and nothing has been sent on it yet.
To switch to a different subdomain, disconnect the current one first, then connect the new one.
Related guides
Last updated on