Docs/Ship/Custom Domains

Custom Domains

Updated May 3, 2026Ship

Connect your own domain (yourbrand.com) to a published XAIO project.

Default URL

Every published XAIO project lives at yoursubdomain.xaio.app with automatic HTTPS via Let's Encrypt and a global CDN.

Adding a custom domain

In the project's Publish settings, add your custom domain (e.g. app.yourbrand.com). XAIO walks you through the DNS setup:

1. Create a CNAME record in your DNS provider pointing your subdomain to the XAIO CloudFront target (shown in the dialog)

2. Wait for DNS propagation (usually a few minutes, can take up to a few hours)

3. XAIO automatically provisions an SSL certificate via ACM

4. The domain becomes active when both DNS and certificate are ready

Apex domains (yourbrand.com without `www`)

Because CNAME on the apex isn't supported by all providers, point an A record to the XAIO target IPs (or use ALIAS / ANAME if your DNS provider supports it). The dialog shows you the exact records.

Multiple domains per project

A single project can be served on multiple domains — for example a marketing version on yourbrand.com and a staging version on staging.yourbrand.com pointing to a different branch.

Removing a domain

Deleting the domain in the Publish settings removes the routing but leaves your DNS record alone — clean it up in your DNS provider afterwards. The default *.xaio.app URL keeps working.

Plan limits

Custom domains are available from Website Builder One (one domain); Website Builder Pro and above include unlimited custom domains. Free uses the default *.xaio.app URL.