diff --git a/src/pages/manage/reverse-proxy/custom-domains.mdx b/src/pages/manage/reverse-proxy/custom-domains.mdx index 2109ae070..39355d77b 100644 --- a/src/pages/manage/reverse-proxy/custom-domains.mdx +++ b/src/pages/manage/reverse-proxy/custom-domains.mdx @@ -134,11 +134,11 @@ If a custom domain returns to **Pending Verification** status - for example, aft ### Deleting a custom domain -To remove a custom domain, click the delete action next to the domain in the list. Deleting a custom domain removes it from your account and makes it unavailable for any new services. Built-in domains (Free or Cluster) cannot be deleted. +Before removing a custom domain, delete or move every service that uses the domain or any of its subdomains. Disabled services also count as dependencies. For example, a service using `app.proxy.example.com` prevents deletion of `proxy.example.com`. - - Before deleting a custom domain, make sure no active services are using it. Services referencing a deleted domain will no longer route traffic correctly. - +Once no services depend on the domain, click the delete action next to it in the list. Built-in domains (Free or Cluster) cannot be deleted. + +If services still reference the domain, NetBird refuses deletion and the API returns HTTP `412 Precondition Failed`. The domain and its services remain unchanged, and no domain deletion activity event is recorded. ## Using domains with services