BunStackDocs

Storefronts

Domains and DNS

Connect your own domain, the DNS records, the statuses, www against apex, changing domain and common errors.

Last updated · 5 min read

Here you connect your own domain to the storefront.

Where: Storefronts › [storefront] › Domain.

Temporary address

Every storefront has the address slug-xxxxxxxx.bunstack.shop with a certificate from the start. The address keeps working when you connect your own domain. It then sends visitors on to your own domain.

The BunStack subdomain card also shows the designer's address, slug.builder.bunstack.co. The badge covers both addresses at Vercel: REGISTERED, VERIFYING or NOT REGISTERED. Re-register on Vercel registers them again.

Connect your own domain

Your own domain needs the Starter plan or higher.

  1. Type the domain in Hostname under Custom domain, for example shop.example.com or example.com.
  2. Tick Also redirect www ↔ apex to this host if the twin should also lead here.
  3. Press Save domain.
  4. Add the DNS records shown under Domain status at your registrar.

BunStack registers the domain with Vercel and checks DNS every 30 seconds while the domain waits. Check now checks at once.

DomainDNS record
Subdomain (shop.example.com)CNAME → cname.vercel-dns.com
Apex (example.com)A → 76.76.21.21
www together with apexCNAME for www → cname.vercel-dns.com

Statuses

StatusMeans
WAITING FOR DNSThe records are missing or have not taken effect yet
ISSUING CERTIFICATEDNS is right. The certificate is being issued
LIVEThe domain answers with a certificate
ERRORThe registration with Vercel failed. The cause is under the status

New records usually take effect within a few minutes. A record you have replaced can keep its old value for up to 24 hours (TTL).

www or apex

You choose which form is the main address. The other answers with a permanent redirect.

  • Also redirect www ↔ apex to this host registers the twin as a redirect: www.example.com for example.com, or the other way round.
  • Only apex and www have a twin. shop.example.com has none.
  • When you untick the box, BunStack removes the twin from Vercel at the next check, if it still points here.

Change or remove the domain

Remove domain asks you to confirm, for example Remove shop.example.com? BunStack then unregisters the domain, and the storefront answers only on the temporary address.

Change domain like this:

  1. Type the new domain in Hostname.
  2. Press Replace domain.

BunStack saves the new domain first. When the save has gone through, it releases the old one with its www twin. If BunStack refuses the new domain, the old one stays and works as before. BunStack refuses a domain that is invalid, used by another storefront or not in the plan. It also refuses the change when your role does not allow it.

Warning: An old domain that is live stops answering until the new one is live. Replace domain asks you to confirm first, for example Replace shop.example.com? Change when few customers are shopping.

At your registrar

Sign in where you manage the domain. Add exactly the rows under Domain status. While the domain waits for DNS, the status card and the rows are at the top of the page.

RegistrarThe DNS records are under
LoopiaKundzon › Domäner › DNS-inställningar
One.comDNS settings › DNS records
BineroDomäner › DNS
  • @ means the domain itself. Loopia shows it as an empty name or as the domain name.
  • When a record of the same type already exists on the same name, replace it. A common example is an old A record pointing to a web host.
  • Leave TTL at the default or 3600. Turn off proxy ("orange cloud").
  • A TXT row shows when the domain is connected to another Vercel account. It proves that you own the domain. Add it once, together with the A or CNAME row.
  • Vercel issues the certificate when the records have taken effect. When the domain has a CAA record, it must allow letsencrypt.org.

Errors

Message or stateCauseDo this
WAITING FOR DNS for hoursThe record points wrong, or an old A record remains on the same nameCompare with the rows under Domain status. Remove old records
The certificate does not comeA CAA record blocks the issuingAllow letsencrypt.org in the CAA record
Works without www but not withCNAME for www is missing, or the twin is offAdd CNAME for www. Tick Also redirect www ↔ apex to this host
ERRORVercel refused the registrationRead the cause under the status. Press Check now
Platform hostname on Vercel is red on Go live, and you cannot press the Go live buttonThe temporary address or the designer's address is not registered with VercelPress Re-register on Vercel on the BunStack subdomain card. Then press Re-run on Go live
Platform hostname on Vercel is yellow on Go liveVercel has registered the addresses but not verified them yetWait a minute and press Re-run