Add a custom domain

Add a custom domain when you want users to access your project through an address you control.

You must have permission to change the domain's DNS records.

Before you begin

You need:

• An Easel project with a Ready Production deployment
• Access to the project's settings
• Access to the domain's DNS provider
• An Owner or Admin role in the workspace (or permission to manage project settings)

A registrar and DNS provider may be the same company, but they are separate roles. Configure records wherever the domain's authoritative nameservers are hosted.

Add the domain

1. Open the project in the Easel dashboard
2. Open Project settings
3. Select Custom Domains
4. Choose Add domain
5. Enter the hostname without a path

Examples:

example.com
www.example.com
docs.example.com

Do not include:

https://
/docs
?query=value

Easel rejects hostnames that are already assigned to another project, then displays the required DNS records.

When adding the domain, choose External DNS (default: CNAME or A at your provider) or Easel DNS (point NS to Easel and manage records in workspace Domains). See DNS configuration.

Add an apex domain

An apex domain is the registrable root of the domain:

example.com

Create an A record using the edge IP addresses shown in the dashboard.

Example structure:

Type:  A
Name:  @
Value: <edge IP shown by Easel>

Use the exact IP values from the dashboard. Do not copy an IP from another project or from outdated documentation.

Do not add an AAAA (IPv6) record unless Easel explicitly shows one. A stale AAAA record can send some users to the wrong endpoint.

Add a subdomain

A subdomain adds a label before the apex domain:

www.example.com
docs.example.com
app.example.com

Create a CNAME record that points to Easel:

Type:  CNAME
Name:  www
Value: cname.easelusercontent.com

DNS dashboards represent the Name field differently. Some expect www; others expect the full hostname. Follow your provider's convention.

Add both apex and www

When you add an apex domain, the dashboard offers to also add www and redirect the apex to www (default on). You can uncheck that option.

For a public website, serving both hostnames avoids duplicate URLs:

example.com
www.example.com

Choose one as the canonical domain and redirect the other to it. See Domain redirects.

Domain already assigned

Each hostname can belong to only one Easel project.

If the hostname is already assigned, remove it from the existing project first, then add it to the new project. Easel does not offer a silent cross-project or cross-workspace transfer.

Complete setup

After adding the domain:

1. Add the required routing record (A or CNAME)
2. Wait for Easel to detect the configuration (the dashboard polls automatically)
3. Confirm that TLS reaches Valid Configuration / Live
4. Test both HTTP and HTTPS
5. Configure a redirect for any alternate hostname

The domain does not need a new deployment. Once live, it follows the current production deployment. See Domains and deployments.