> For the complete documentation index, see [llms.txt](https://docs.diaflow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.diaflow.io/workspace/general-1/custom-domain.md).

# Custom domain

Use a custom domain to give your workspace a branded web address.

Once setup is complete, your team can sign in and use Diaflow from that address.

The workspace owner can:

* Set up a new custom domain
* View custom domain information
* Remove custom domain

{% hint style="info" %}
Only the **workspace owner** can manage the custom domain.
{% endhint %}

## Set up a new custom domain

Open **Workspace settings** and click **Set up a Custom Domain**.

<figure><img src="/files/FnT6lQfvIRvg12i1gdG3" alt=""><figcaption></figcaption></figure>

> **GIF placeholder:** Show how to open **Workspace settings** and click **Set up a Custom Domain**.

### Step 1: Enter your domain

1. Enter the domain or subdomain you want to use.
2. Click **Next**.

Example: `app.yourcompany.com`

{% hint style="info" %}
You must own the domain or have permission to create a subdomain.
{% endhint %}

<figure><img src="/files/DvSxGGd2W0GbypznjBE7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RqWALaAqFYiOIidS6ZYB" alt=""><figcaption></figcaption></figure>

> **GIF placeholder:** Show how to enter a custom domain, review the example format, and click **Next**.

### Step 2: Verify domain ownership

Diaflow generates a TXT record for verification:

* **TXT** — **Name** — **Target**

<figure><img src="/files/PZ5zbaKlbVaxHTXTOhrk" alt=""><figcaption></figcaption></figure>

#### Add the TXT record in your domain provider

Go to the domain provider you use to manage your DNS settings.

For example, if you use **name.com**, add the TXT record with these values:

* **Type** = TXT
* **Host** = Paste the **Name** value from Diaflow
* **Answer** = Paste the **Target** value from Diaflow
* **TTL** = 300

Click **Add Record** to save the change.

<figure><img src="/files/Ose6xHa3WEGUNHHAWOL6" alt=""><figcaption></figcaption></figure>

Return to Diaflow and confirm that you updated your DNS settings.

<figure><img src="/files/SMHIbphfMPc5AKM2UBvO" alt=""><figcaption></figcaption></figure>

Click **Start Verification**.

<figure><img src="/files/wUfCXWa0Xvvz2SfKBEbc" alt=""><figcaption></figcaption></figure>

> **GIF placeholder:** Show the full verification flow — copy the TXT values, add them in the domain provider, return to Diaflow, confirm the update, and click **Start Verification**.

If verification succeeds, Diaflow moves to the next step.

If verification fails, review your DNS record in your domain provider and try again.

<figure><img src="/files/ZoC6uP2ap6MHhExJFRuL" alt=""><figcaption></figcaption></figure>

### Step 3: Configure your DNS

Diaflow generates two DNS records:

* **CNAME** — **Name** — **Target**
* **ANAME** — **Name** — **Target**

<figure><img src="/files/oYgwCmb6VOecSxBbmWn4" alt=""><figcaption></figcaption></figure>

#### Add the DNS records in your domain provider

Go back to your domain provider and add both records.

For example, if you use **name.com**, set them up like this:

#### Record 1

* **Type** = `CNAME`
* **Host** = Paste the **Name** value from Diaflow, without your root domain
* **Answer** = Paste the **Target** value from Diaflow
* **TTL** = 300

Click **Add Record** to save the change.

<figure><img src="/files/DyEJsefJZL3sGB7LYRwL" alt=""><figcaption></figcaption></figure>

#### Record 2

* **Type** = ANAME
* **Host** = Paste the **Name** value from Diaflow, without your root domain
* **Answer** = Paste the **Target** value from Diaflow
* **TTL** = 300

Click **Add Record** to save the change.

<figure><img src="/files/MRSEqI53iIKFrPl78y1P" alt=""><figcaption></figcaption></figure>

After you add both records, click **Next** in Diaflow.

<figure><img src="/files/3LvrzP6cjCFVmtbCSygi" alt=""><figcaption></figcaption></figure>

> **GIF placeholder:** Show how to add the **CNAME** and **ANAME** records, then return to Diaflow and click **Next**.

### Step 4: Wait for activation

Diaflow checks your domain. This can take up to 30 minutes, but it usually finishes in 1 to 2 minutes.

You can click **Close the window** and return later to check the status.

<figure><img src="/files/QoWvJoQVnTH1tAE7DtZU" alt=""><figcaption></figcaption></figure>

You can view the current status in **Workspace settings**.

<figure><img src="/files/2KlmbOEb3BDtFUVXZ2IA" alt=""><figcaption></figcaption></figure>

When the status shows **successful**, your custom domain is ready to use.

<figure><img src="/files/Cyo9JjyXIgxAqxo4oTGM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wR51hv4igt5DEdZNmuNd" alt=""><figcaption></figcaption></figure>

> **GIF placeholder:** Show the status changing to **successful** and the custom domain opening correctly.

## View custom domain information

After your custom domain is active, go to **Workspace settings** and click **Manage Domain**.

<figure><img src="/files/XLiDq4Yx6AMUTMQH21EY" alt=""><figcaption></figcaption></figure>

Diaflow opens a pop-up with your domain details.

<figure><img src="/files/Sj132EVKALWHLwtqOlkw" alt=""><figcaption></figcaption></figure>

> **GIF placeholder:** Show how to open **Manage Domain** and review the saved domain details.

## Remove a custom domain

To remove the custom domain, go to **Workspace settings** and click **Remove domain and back to default**.

<figure><img src="/files/brfQazPynOlKffNr98c7" alt=""><figcaption></figcaption></figure>

Diaflow shows a confirmation pop-up.

* **Confirm** removes the custom domain and switches your workspace back to the default address.
* **Cancel** closes the pop-up without making changes.

<figure><img src="/files/uz2XS5lHahc71hsRJE4B" alt=""><figcaption></figcaption></figure>

After removal, your workspace uses the default address again.

<figure><img src="/files/kdd3MBlogQa5Jvma6uof" alt=""><figcaption></figcaption></figure>

> **GIF placeholder:** Show how to remove the custom domain, confirm the action, and return to the default workspace address.

{% hint style="info" %}
After removal, users can no longer sign in with the custom domain.
{% endhint %}

### Need help?

* Need to update your workspace branding or web address? Go to [Workspace settings](broken://spaces/Rdo1pkMnofwxf3lpWftw/pages/57CGNwAcpxFLizSiDoZl).
* Need to manage access for teammates who use this workspace? Go to [Users](/workspace/users.md).
* Need help with domain setup or DNS records? Contact <support@diaflow.io>.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.diaflow.io/workspace/general-1/custom-domain.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.