Recent searches

in

Disconnect a Custom Domain from your Organization

Last modified: November 5th, 2026

Permissions required

Members of the Owners, Developers, and Partner Default Permission Groups, or Custom Permission Groups with the base-domain:delete:write permission, can disconnect Custom Domains from an Organization.

You cannot undo disconnecting a Custom Domain. If your Custom Domain uses CloudCannon DNS, disconnecting it also deletes every DNS record for the domain, including your mail records. Before you disconnect, move your domain's nameservers to another DNS Provider and add the records you need there.

A Custom Domain is a domain you own and connect to your CloudCannon Organization, so visitors reach your Site at your own address (e.g., cloudcannon.com). If you have connected a Custom Domain to your Organization and added the Custom Domain to your Site, CloudCannon will host your website content at that web address.

Disconnecting a Custom Domain from your Organization will allow you to add the domain to a different CloudCannon Organization. Disconnecting doesn't change your registration at your domain registrar.

To protect you from accidentally taking your website down by disconnecting your Custom Domain, CloudCannon prevents you from disconnecting the domain from your Organization while:

  • Any Site still uses the domain (e.g., 1 site still uses it.).
  • Any Redirect Subdomain on the domain sends visitors to another domain (e.g., promo.example.com redirects elsewhere.).
  • Any Redirect Subdomain on another domain in your Organization sends visitors to this domain (e.g., shop.example.net redirects here from other domains.).
  • Any Redirect Subdomain on a domain you can't view sends visitors to this domain (e.g., 1 redirect on domains you cannot view points here.).

The Danger section lists each reason, and the Disconnect [Base Domain] button stays disabled until you resolve them all.

When you disconnect the domain, CloudCannon also removes the Subdomains that have no Site, and the Redirect Subdomains that send visitors to the domain itself or to another Subdomain on it. The Danger section lists these Subdomains under Disconnecting also removes: before you disconnect, or shows Nothing else is removed with [Base Domain].

A screenshot of the Danger section on the Domain Settings tab shows that disconnecting cannot be undone, a notice that shop.example.net redirects here from other domains, careers.example.com and jobs.example.com listed under Disconnecting also removes, and the disabled Disconnect example.com button.
The Danger section with a blocker

Once you disconnect the domain, another CloudCannon account can connect it. If the domain uses CloudCannon DNS, its nameservers change the next time it is connected.

The Danger section only appears on the Domain Settings tab if you have the base-domain:delete:write permission. If you can't see it, ask someone in your Organization who has that permission.

Before we begin, this article assumes you have already removed the Custom Domain from all CloudCannon Sites and deleted any Redirect Subdomains that send visitors to another domain, or to this domain from another domain.

To disconnect a Custom Domain from your Organization:

  1. Log in to CloudCannon.
  2. Select the Organization from which you want to disconnect the Custom Domain.
  3. Click the Custom Domains link in the App Sidebar. CloudCannon will open the Domains Browser.
  4. Click the Card for the domain you want to disconnect. CloudCannon will open the Summary tab of the Domain page for this Custom Domain.
  5. Click the Domain Settings tab. CloudCannon will open the Details section.
  6. Click the Danger link in the side navigation. CloudCannon will open the Danger section.
  7. Click the Disconnect [Base Domain] button. CloudCannon will open the Disconnect [Base Domain]? modal.
  8. Click the Disconnect [Base Domain] button in the modal to confirm.

CloudCannon will disconnect the Custom Domain from your Organization, show [Base Domain] has been disconnected, and return you to the Domains Browser. If no other Custom Domains are connected to your Organization, CloudCannon will open the Connect a Custom Domain page instead.

A screenshot of the Danger section on the Domain Settings tab shows a warning that disconnecting cannot be undone, a notice that 1 site still uses it with a link to remove it from that site, old.example.com and www.example.com listed under Disconnecting also removes, and the disabled Disconnect example.com button.
The Danger section on the Domain Settings tab

Related Resources

Open in a new tab