Attach a custom domain

Custom domains let you serve your production deployment on your own hostname. Easel provisions and renews TLS certificates after DNS points at the platform. Preview deployments keep generated preview URLs only; they do not receive custom domains.

Add a domain

1. Open your project in the dashboard.
2. Go to Project settings → Custom Domains.
3. Add the apex domain or subdomain you want to serve.
4. Create the DNS records Easel shows for that hostname.
5. Wait for DNS to propagate and for certificate provisioning to finish.

Domain status in the dashboard moves from pending DNS through TLS provisioning to live.

DNS records

Use the records shown in project settings:

• Subdomain (for example www.example.com): create a CNAME to cname.easelusercontent.com.
• Apex (for example example.com): create an A record to the edge IPs Easel lists for your domain.

Some registrars also support ALIAS or ANAME for apex domains. Follow the instructions in the dashboard if your DNS provider offers those options.

You can add www and configure an apex ↔ www redirect in project settings. Redirects run at the edge.

TLS certificates

When DNS verifies correctly, Easel issues a certificate for that hostname automatically. You do not upload certificates or manage renewals.

The first request after DNS points at Easel may fail until the certificate is ready. Retry after a short wait. Later requests use the provisioned certificate. See Encryption for HTTPS behavior on Easel CDN.

What custom domains serve

Custom domains always serve the project’s current production deployment. Updating production (a push to the production branch) updates every custom domain attached to the project.

For generated preview and production hostnames on Easel, see Deployment URLs.

Related guides

• Encryption: HTTPS, HTTP Strict Transport Security (HSTS), and certificate behavior
• Environments: preview vs production
• Troubleshooting: DNS and TLS first-request issues