Publish and get found

Use your own domain with DNS records

Show your website on your own domain: add two DNS records at your registrar, check them, and go live. Includes what to do while DNS is still updating.

A custom domain is an address you own, such as example.com or shop.example.com. To use one, you add two DNS records where the domain is managed, then ask eComGear to check them. DNS changes can take up to 48 hours to spread across the internet, so plan for a wait.

What you need

  • A domain you own, and access to the place where its DNS records are edited. This is usually your registrar or your DNS provider.
  • A project that is ready to publish. See Publish your website.
  • Edit access to the project.

If Add custom domain shows a small lock, custom domains are not switched on for your workspace. See the pricing page or ask support.

Step 1: Enter your domain

  1. In the editor, select Publish at the top right.
  2. If your site is not live yet, select Publish in the panel to open the Publish window. You do not have to publish first. If it is live, select Edit settings instead.
  3. In the window, select Add custom domain.
  4. Type your domain in the box. Use the root domain (example.com) or a subdomain (app.example.com). If you paste a full address with https:// or a path, eComGear removes those parts.
  5. Select Prepare DNS Setup.

A message says DNS setup generated. Add these records, then verify. If you see Enter a valid domain like example.com or app.example.com, check the spelling. If you see that the domain is already connected to another project, it belongs to another site in eComGear. Remove it there first.

Step 2: Add both DNS records

A box titled Add BOTH DNS records at your registrar appears. Add both records. The site cannot go live with only one.

Record Type Host Value
Record 1 A record A @ for a root domain, or the subdomain name, for example app An address shown in the box
Record 2 TXT verification TXT _ecomgear-verify for a root domain, or _ecomgear-verify.app for the subdomain app A code shown in the box

Use the copy icon next to each Host and Value so you do not mistype them.

Some registrars add your domain name to the host for you. Others do not. Under the TXT host, the box shows Some registrars need: and the full name, for example _ecomgear-verify.example.com. Use that full name if your registrar asks for it.

Domains that end in two parts, such as .com.hk, are recognised as root domains, so brand.com.hk uses @.

Step 3: Check DNS

  1. Wait a few minutes after you save the records at your registrar.
  2. Select Check DNS. The button shows Checking DNS… for a moment.
  3. Read the DNS check box.
What you see What it means
A tick next to A record, with Pointing to and an address The A record is correct.
A cross with Expected and Found The A record points somewhere else or is missing. Compare the two values.
A tick next to TXT at and Verified ✓ The verification record is correct.
A cross next to TXT at The TXT record is missing, on the wrong host, or has a different value.
Neither record found yet DNS is probably still updating. It can take up to 48 hours.

You can press Check DNS as often as you like. It does not publish anything and does not use your publish allowance.

Step 4: Verify DNS and go live

  1. When both records show a tick, select Verify DNS and Go Live.
  2. eComGear checks DNS again. If a record is still missing, you see DNS not verified. Missing or wrong: and the missing record. Nothing is deployed and nothing is counted. Fix the record and try again.
  3. If DNS is correct, eComGear deploys your site and switches the domain on. The button shows Deploying and verifying….
  4. You see Custom domain is live and a link. Use Copy URL or Open Site to test it.

After this, the window shows Update Production Site for later changes. See Update a site that is already live.

When it does not work

Problem What to try
Records look right but nothing is found Wait. Changes can take up to 48 hours. Check again later.
The A record shows a different address Delete the old A record at your registrar and add the one from the box.
TXT record not found Use the host from Some registrars need:. Make sure you copied the whole value.
Your DNS provider is Cloudflare Set the A record to DNS only (grey cloud), not proxied (orange cloud). Then check again.
DNS check failed The checking service did not answer. Wait a minute and try again.
Hosting deploy failed or Domain activation failed DNS was fine but the switch-on failed. Press Verify DNS and Go Live again. If it repeats, see Troubleshooting.

After the domain is connected

Open Settings, then Domains, for this project. Each domain shows a status:

Status Meaning
Pending DNS Waiting for your records.
Verifying eComGear is checking them.
Active The domain serves your site.
Failed or Inactive Something needs attention.

From there you can View DNS records, Check DNS, Redeploy and Remove domain. eComGear rechecks pending domains about every minute.

If eComGear can no longer see your records, a warning says it will switch the domain off if you do not fix them within a day. Your site stays online at its eComGear address. When you fix the record, the domain turns back on by itself.

For records you manage inside eComGear, see Manage DNS records.