> For the complete documentation index, see [llms.txt](https://docs.release.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.release.com/guides-and-examples/domains-and-dns/managing-your-domains.md).

# Manage domains

## View domains

Navigate to **Configuration** and click the **Domains** tab to view all domains associated with your cloud integrations. This page will show you the domain name, the cloud integration it is associated with, name servers, and the status of the domain.

![View and create domains](https://585411240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1neGLLQ0sDXeK6ooSo%2Fuploads%2Fgit-blob-023c3116be02abe82cfe024b50543eb11d7c24d5%2Fview-and-create.png?alt=media)

## Create a domain

Click the purple **Create Domain** button.

In the dialog, select the cloud integration the domain will be associated with and type in the domain name that will be used in clusters for your apps in Release.

![New domain dialog](https://585411240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1neGLLQ0sDXeK6ooSo%2Fuploads%2Fgit-blob-fb43aecdeab21200ff6910b8834e4ff01e8f198d%2Fcreate-form.png?alt=media)

Click **Create Domain**. This will create a DNS record in the chosen cloud integration and return the name servers associated to it.

![Domain details page](https://585411240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1neGLLQ0sDXeK6ooSo%2Fuploads%2Fgit-blob-065e2bd5d86029eea0c08cafa515f7740973901a%2Fdomain-example-org.png?alt=media)

Now you can use the given name servers to add NS and CNAME records to your DNS manager for the top-level domain you have used. In this example, the top-level domain is `example.org`. You can add an NS record to point to the given name servers and a CNAME wildcard record that points to `releasedomain.example.org`. Read [our External DNS guide](/guides-and-examples/domains-and-dns/external-dns.md) for more information on setting up your external DNS.

## Verify a domain

Once you have updated the DNS records in your host, return to the Domain Info page and click the **Verify** button under the **Actions** dropdown to compare the name servers on Release to those associated with the domain.

![Verify domain](https://585411240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1neGLLQ0sDXeK6ooSo%2Fuploads%2Fgit-blob-38346888a269caed843977cb0a4629c6ec22c838%2Fverify.png?alt=media)

In this example, Release will check to see which name servers are associated with `releasedomain.example.org` using DNS lookups. If the name servers match, the domain will show as verified on the Domain Info page. Verified domains can be used later to create a cluster.

## Remove a domain

To remove a domain, go to the Domains page and click the domain to see the Domain Info page.

![Domains page](https://585411240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1neGLLQ0sDXeK6ooSo%2Fuploads%2Fgit-blob-de0034153ea15e678a1d49989494fda83f777b33%2Fdelete.png?alt=media)

Click the **Delete** button under the **Actions** dropdown to show the delete confirmation dialog. The **Delete** button will be disabled if this domain is currently in use by any running clusters.

{% hint style="danger" %}
You may only remove domains which are not in use with any active clusters. You can tell if any clusters are using a domain by navigating to the Domain Info page looking at the "In Use By" section.
{% endhint %}

![Domain delete confirmation](https://585411240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1neGLLQ0sDXeK6ooSo%2Fuploads%2Fgit-blob-5fe65618fef576f8def75c429dddde66dbd2ced7%2Fdelete-confirm.png?alt=media)

Type in the word `DELETE` and click the **Delete** button. This will remove the domain from Release and attempt to remove any DNS entries created for it.

{% hint style="danger" %}
If the domain was part of an existing DNS entry created outside of Release, it will not be removed from the cloud provider. You may have to manually remove any entries which Release did not explicitly create in those situations.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.release.com/guides-and-examples/domains-and-dns/managing-your-domains.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.