Help
Connect your custom domain
Add two or three DNS records at the company where you bought your domain. We see them, issue the HTTPS certificate and your site goes live. Most domains are done in under an hour.
The records to add
DNS records tell browsers where your domain lives. Yours should point at Buildan.app. Your site's Domains page shows the exact records for your domain; they look like this:
| Type | Host | Value |
|---|---|---|
| A | @@ or leave blank: the root, yourbusiness.com | 66.241.124.139 |
| AAAA | @the same, for IPv6 | 2a09:8280:1::200:5183:0 |
| CNAME | wwwwww.yourbusiness.com | domains.buildan.app |
The Host field: type @, not your domain
Every provider adds your domain to whatever you type in the Host (or Name) field. So type @ for the root (some providers want it blank) and www for www. Typing the full domain creates a record for yourbusiness.com.yourbusiness.com, and your domain keeps waiting. The Domains page spots this and tells you.
Root and www
The root (or apex) is your domain on its own, yourbusiness.com. DNS does not allow a plain CNAME there, so it uses an A record and an AAAA record with our addresses. www is a subdomain, so it uses one CNAME to domains.buildan.app, and keeps working if our addresses ever change. Other subdomains, like shop.yourbusiness.com, work like www with Host shop.
Add both forms as domains in Buildan.app so both work, and pick the primary one, the address visitors end up on.
Step by step for your registrar
Jump to yours: Namecheap, GoDaddy, Cloudflare, Squarespace Domains (formerly Google Domains), Porkbun, Hostinger, IONOS, Amazon Route 53.
Namecheap
- Sign in, open Domain List, click Manage next to your domain, then open the Advanced DNS tab.
- Delete the URL Redirect Record for @ and the CNAME Record www pointing to parkingpage.namecheap.com.
- For the root domain, click Add New Record (under Host Records). Set Type to A, Host to
@and Value to66.241.124.139. Click the green check mark (Save All Changes). Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Host
www, Valuedomains.buildan.app. Click the green check mark (Save All Changes). - That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
Instead of A and AAAA: ALIAS Record, Host @, Value domains.buildan.app.
Type only @ or www in Host. Namecheap adds your domain by itself, so jijojohn.me in Host becomes jijojohn.me.jijojohn.me.
If you use Namecheap Email Forwarding, keep its MX records and the TXT record (v=spf1 include:spf.efwd.registrar-servers.com ~all) under Mail Settings. They do not affect your site.
GoDaddy
- Sign in, open your Domain Portfolio, select the domain, then select DNS.
- Delete the A record for @ with the value Parked (or a parking address), and any Forwarding set up for the domain.
- For the root domain, click Add New Record. Set Type to A, Name to
@and Value to66.241.124.139. Click Save. Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Name
www, Valuedomains.buildan.app. Click Save. - That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
GoDaddy usually already has an A record for @. Select Edit on it and change the Value instead of adding a second one.
GoDaddy has no ALIAS for the root, so use the A and AAAA records.
Cloudflare
- Sign in to the Cloudflare dashboard, select your domain, then open DNS and Records.
- Delete old A, AAAA or CNAME records for the same name.
- For the root domain, click Add record. Set Type to A, Name to
@and IPv4 address to66.241.124.139. Click Save. Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Name
www, Targetdomains.buildan.app. Click Save. - On every record, set Proxy status to DNS only (grey cloud).
- That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
Instead of A and AAAA: CNAME, Name @, Target domains.buildan.app (Cloudflare flattens a CNAME at the root automatically).
Turn the Proxy status off for every record: DNS only, the grey cloud. With the orange cloud on, we cannot see your records or issue your HTTPS certificate.
Squarespace Domains (formerly Google Domains)
- Sign in, open the Domains dashboard, click your domain, then DNS and DNS Settings.
- Delete the Squarespace Defaults preset (its A records 198.185.159.144, 198.185.159.145, 198.49.23.144, 198.49.23.145 and the www CNAME to ext-cust.squarespace.com), with the trash icon next to the preset.
- For the root domain, click Add record (under Custom records). Set Type to A, Host to
@and Data to66.241.124.139. Click Save. Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Host
www, Datadomains.buildan.app. Click Save. - That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
Instead of A and AAAA: ALIAS, Host @, Data domains.buildan.app.
Keep presets for email, such as Google Workspace. They hold your MX records.
Porkbun
- Sign in, open Domain Management, hover over your domain and click DNS.
- Delete the default ALIAS and CNAME records pointing to pixie.porkbun.com (the parking page).
- For the root domain, click Add (in Manage DNS Records). Set Type to A, Host to
(blank)(leave it empty) and Answer to66.241.124.139. Click Add. Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Host
www, Answerdomains.buildan.app. Click Add. - That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
Instead of A and AAAA: ALIAS, Host blank, Answer domains.buildan.app.
Leave Host empty for the root. Porkbun adds your domain by itself.
Hostinger
- Sign in to hPanel, open Domains, select your domain, then DNS / Nameservers.
- Delete the default A record for @ and the CNAME for www that point to Hostinger's parking or hosting.
- For the root domain, click Add record (in Manage DNS records). Set Type to A, Name to
@and Points to to66.241.124.139. Click Add Record. Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Name
www, Points todomains.buildan.app. Click Add Record. - That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
Instead of A and AAAA: ALIAS, Name @, Points to domains.buildan.app.
DNS records can be edited in hPanel only while the domain uses Hostinger's nameservers.
IONOS
- Sign in, open Domains & SSL, open the Actions menu (three dots) next to your domain and choose DNS.
- Delete the default A and AAAA records for @ (IONOS asks to replace conflicting records: accept).
- For the root domain, click Add record. Set Type to A, Host name to
@and Points to to66.241.124.139. Click Save. Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Host name
www, Points todomains.buildan.app. Click Save. - That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
The Host name of an existing record cannot be changed. Add a new record and delete the old one.
Amazon Route 53
- In the AWS console open Route 53, Hosted zones, then select your domain.
- Delete old A, AAAA or CNAME records for the same name, including Alias records to S3 or CloudFront.
- For the root domain, click Create record. Set Record type to A, Record name to
(blank)(leave it empty) and Value to66.241.124.139. Click Create records. Add a second record the same way with type AAAA and2a09:8280:1::200:5183:0. - For www, add a CNAME record: Record name
www, Valuedomains.buildan.app. Click Create records. - That is all. Buildan.app checks every minute, issues the HTTPS certificate and emails you when the domain is live. To see it sooner, click Check now on your site's Domains page.
Route 53 Alias records only point to AWS resources, so use the A and AAAA records for the root.
Another provider? Look for DNS, DNS settings, DNS zone or Zone editor. The fields are named much the same: Type, Host or Name, Value, Points to or Target, TTL.
CNAME flattening and ALIAS
Some providers can point the root at a name instead of addresses: Cloudflare does it automatically for a CNAME at @ (CNAME flattening), others call it an ALIAS or ANAME record (Namecheap, Porkbun, Squarespace Domains, Hostinger). If yours has it, you can use one record instead of A and AAAA:
| Type | Host | Value |
|---|---|---|
| ALIAS (or flattened CNAME) | @ | domains.buildan.app |
Only use this when your provider names the option. A plain CNAME at the root, where the provider does not flatten it, hides your other records there, email included. The Domains page warns you when it sees one.
Remove old records
Your domain must point only at Buildan.app. If any A, AAAA or CNAME record for the same Host points somewhere else, some visitors land on the old site and the certificate cannot be issued. Delete them. The usual ones:
- GitHub Pages: A records 185.199.108.153, 185.199.109.153, 185.199.110.153 and 185.199.111.153, AAAA records 2606:50c0:8000::153 to 2606:50c0:8003::153, a www CNAME to yourname.github.io.
- Wix: A records such as 185.230.63.107, 185.230.63.171 and 185.230.63.186, a www CNAME ending in wixdns.net.
- Squarespace: A records 198.185.159.144, 198.185.159.145, 198.49.23.144 and 198.49.23.145, a www CNAME to ext-cust.squarespace.com.
- Netlify: the A record 75.2.60.5, a www CNAME ending in netlify.app.
- Vercel: the A record 76.76.21.21 (or 216.198.79.1), a www CNAME ending in vercel-dns.com.
Also turn off domain forwarding (URL redirect) and parking pages at your provider: they are records too. The Domains page names the old host when it recognizes it, for example "Your old GitHub Pages records are still there".
Keep your email records
Connecting your site does not touch email. Keep these as they are:
- MX records, which deliver your mail (Google Workspace, Microsoft 365, Zoho, your provider's email forwarding).
- TXT records for SPF (they start with
v=spf1), DKIM and DMARC, and verification TXT records from other services. - CNAME records for other subdomains, such as
mailor DKIM keys.
TTL and how long it takes
Each record has a TTL (time to live): how long other DNS servers may keep a copy. Automatic or 1 hour is fine. New records usually show within minutes. When you change a record, servers that saw the old one keep it until its TTL runs out, usually up to an hour, rarely up to 48 hours.
You do not need to wait on the page: we check every minute for the first half hour, then every 5 minutes, and email you when the domain is live. We read your records straight from your provider's own DNS servers, so a cached old answer does not hold your domain up. When some caches still have the old values, the Domains page says so.
HTTPS certificate
Once the records are found we request a free certificate for your domain, usually issued within a few minutes. The status moves from "Waiting for DNS" to "Issuing certificate" to "Active". It renews automatically. A certificate can only be issued when every record for the name points at Buildan.app, so a leftover old record or the Cloudflare proxy holds it up.
Troubleshooting
It has said "Waiting for DNS" for a long time
Open the Domains page and click Check now: it names the problem when it finds one. The most common one is the full domain typed in the Host field. Type only @ (or leave it blank) for the root and www for www.
My provider will not let me add a CNAME for @
That is expected: a plain CNAME is not allowed at the root. Use the A and AAAA records, or an ALIAS or flattened CNAME if your provider has one.
It says the domain also points somewhere else
There is a record left from your old host, a parking page or a domain forward. Delete every other A, AAAA or CNAME record for the same Host. Email records (MX, TXT) can stay.
It shows Cloudflare addresses
The Cloudflare proxy is on. Edit each record and set Proxy status to DNS only (grey cloud).
The records are right but some visitors still see the old site
Old answers are cached until their TTL runs out, often an hour, sometimes a day. Nothing to change: we read your provider's own DNS servers, so your domain goes live as soon as the records are right there, and some visitors see the old site until their cache expires.
Does connecting my site change my email?
No, as long as you keep the MX records and the TXT records for SPF, DKIM and DMARC. Only the records for your site change.
The site loads but the browser warns about the certificate
The certificate is issued a few minutes after the records are found. If it is still missing after an hour, check that no AAAA or A record points elsewhere, then click Check now.
Should I add the root, www, or both?
Both, usually. Add each as its own domain in the Domains page. Make the one you want people to see the primary domain.
Still stuck? Open your dashboard, go to your site's Domains page and click Check now: it explains what it sees.