Remove or move a domain

Removing a domain detaches it from an Easel project. It does not cancel the domain registration or automatically change records at an external DNS provider.

Before removing a domain

Check whether the hostname is used for:

• Production traffic
• API requests
• Authentication callbacks
• Webhooks
• Email links
• Mobile deep links
• Customer integrations
• Cookies
• Search indexing

Removing an active domain can interrupt users once Easel's routing update takes effect (edge manifests refresh within about 30s).

Remove a domain

1. Open the project's Custom Domains settings
2. Select the domain
3. Choose Remove
4. Confirm removal

Also update or remove related redirects that pointed at this hostname.

Move a domain between projects

Easel does not provide an atomic transfer. Use remove-then-add:

1. Prepare the destination project and Production deployment
2. Remove the hostname from the source project
3. Add the hostname to the destination project
4. Keep DNS unchanged when it already points at Easel
5. Confirm the destination project responds
6. Update redirects and application configuration

There can be a short window where the hostname is unassigned. During that window, requests that still reach Easel receive a not-found response rather than another customer's project.

Move a domain between workspaces

There is no dedicated cross-workspace transfer. Remove the domain from the source workspace's project, then add it in the destination workspace after you have access to both.

DNS verification (A or CNAME pointing at Easel) must succeed again on the destination project.

After removal

When DNS still points to Easel after the domain is detached, Easel returns a safe unassigned-domain response (not another customer's site).

Remove or update the DNS record after the domain no longer needs to route to Easel.