Domain verification
How Easel confirms that DNS routes your domain to the platform.
Easel verifies a custom domain by checking that its DNS records point at Easel.
Verification is required before Easel provisions a TLS certificate and marks the domain live. There is no separate TXT ownership challenge for customer domains today.
How verification works
When you add a domain, its status starts as Invalid DNS configuration (pending DNS).
Easel checks:
| Domain type | Expected record |
|---|---|
Apex (example.com) | A record matching an Easel edge IP |
Subdomain (www.example.com) | CNAME to cname.easelusercontent.com |
The dashboard refreshes this check automatically while the domain is pending or provisioning TLS. You can also choose Refresh.
Add the routing record
- Copy the record type and value from Project settings → Custom Domains
- Open the authoritative DNS provider
- Add the A or CNAME record exactly as shown
- Save the record
- Return to Easel and wait for verification, or choose Refresh
Some providers automatically append the apex domain to the Name field. Avoid creating a duplicated hostname such as www.example.com.example.com.
Verification and traffic
Passing DNS verification means Easel can see the correct routing record. It does not by itself mean every visitor already reaches Easel; resolvers may still cache older answers.
Keep the A or CNAME record in place after the domain is live. Easel re-checks DNS on refresh. If the record disappears or points elsewhere, the domain returns to a pending DNS state and renewal can fail.
Domain conflicts
Each hostname can be assigned to only one project across Easel.
If create fails because the hostname is already taken, remove it from the other project first. Soft-removed domains may still occupy the hostname until they are fully deleted. There is no cross-workspace transfer flow and no TXT-based claim that silently takes a domain from another account.
Domain statuses
| Status | Meaning |
|---|---|
| Invalid DNS configuration | Required A or CNAME is missing or incorrect |
| Provisioning SSL certificate | DNS verified; certificate issuance in progress |
| Valid Configuration | Domain is live and ready to serve |
| Configuration Error | Setup failed; check DNS and certificate details |
| Removed | Domain was detached from the project |
DNS verification status is separate from whether the project's current production deployment is healthy. A live domain still needs a Ready Current production deployment to serve application content.