# Set Up Custom Domain

{% embed url="<https://youtu.be/4PGeGU_KXao>" %}

The **Custom Domain** feature in Agency Handy allows users to link their own domain (e.g., `client.yourbusiness.com`) to their workspace. This enables businesses to create a professional, branded experience and make the platform easily accessible to clients and internal users.

#### Goals

* Reinforce agency branding through a unique web address.
* Enhance professional credibility with a custom domain.
* Simplify client and team access using a familiar domain.

#### Pre-conditions

**Permissions Required:** Only **Super Admins** and **Admins** can configure a custom domain.

**Domain Control:** You must own the domain and have access to modify its DNS settings.

***

#### Table of Contents

1. [Accessing the Custom Domain Panel](#id-1.-accessing-the-custom-domain-panel)
2. [Adding a Custom Domain](#id-2.-adding-a-custom-domain)
3. [Configuring DNS Settings](#id-3.-configuring-dns-settings)
4. [Verifying and Saving Domain](#id-4.-verifying-and-saving-domain)
5. [Monitoring Connection Status](#id-5.-monitoring-connection-status)
6. [Deleting or Updating Domain](#id-6.-deleting-or-updating-domain)
7. [Important Notes](#important-notes)

***

### 1. Accessing the Custom Domain Panel

1. Log in to your **Agency Handy** account.
2. Navigate to **Workspace Settings**.
3. Click on **Custom Domain**.

📌 *Only users with administrative access will see this option.*

***

### 2. Adding a Custom Domain

1. Click on the **+ Add Custom Domain** button.
2. Enter your desired subdomain (e.g., `client.yourbusiness.com`).\ <br>

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

   <br>

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

⚠️ *Do not use `www` as your subdomain. It may cause configuration issues.*

***

### 3. Configuring DNS Settings

1. Copy the **Type, Name, and Value** provided on the screen.
2. Log in to your domain registrar (e.g., GoDaddy, Namecheap, Cloudflare).
3. Add a **CNAME record** as instructed.
4. If using **Cloudflare**, make sure **Proxy Status** is set to **DNS only** (not proxied).

<figure><img src="/files/0PzVIM4efIauksueEJ2N" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/0OOuEEuXMZ77ZJK79Fhg" alt=""><figcaption><p>Cloudflare DNS Setup</p></figcaption></figure>

<figure><img src="/files/kYj0IdYOrmvKq5JCNPXN" alt=""><figcaption><p>Add record and save</p></figcaption></figure>

💡 *Use a DNS propagation tool like* [*dnschecker.org*](https://dnschecker.org) *to track status.*

***

### 4. Verifying and Saving Domain

1. After setting up DNS, return to Agency Handy.
2. Click **Save Domain**.\ <br>

   <figure><img src="/files/ESvXysIjo6vca0d5wO7m" alt=""><figcaption><p>Save the Custom Domain</p></figcaption></figure>
3. Status will initially show **Disconnected**. Wait 2 minutes to 48 hours.
4. Click **Refresh** to check the status.

<figure><img src="/files/w2GUAjsPxnCGq6tyMvZ3" alt=""><figcaption><p>Domain Successfully connected</p></figcaption></figure>

✅ *Once verified, the status will change to **Connected**.*

***

### 5. Monitoring Connection Status

* Use tools like [dnschecker.org](https://dnschecker.org) to ensure your domain has fully propagated.
* Look for green check marks in all regions for your CNAME record.
* DNS changes may take time depending on your registrar and location.

***

### 6. Deleting or Updating Domain

* To delete your custom domain:
  * Click the **Delete** button next to the domain entry.
  * Confirm the deletion.
* The workspace will revert to the default Agency Handy URL.
* You may re-add the domain at any time using the same steps.

⚠️ *Deleted domains can be added again with proper DNS settings.*

***

### 📝 Important Notes

* **Custom Domain Purpose:** Helps establish a professional and branded web presence for client access.
* **Subdomain Rule:** Always use a valid subdomain (e.g., `portal.agencyname.com`) and avoid using `www`.
* **DNS Records:** Must add the exact records provided. Incorrect or missing records will prevent connection.
* **Cloudflare Users:** Must disable proxy (set to DNS only) for successful verification.
* **Verification Time:** Can vary from a few minutes to 48 hours due to DNS propagation delays.
* **Admin Access Only:** Configuration rights are limited to Super Admins and Admins.
* **No Immediate Connection?** Use DNS tools to troubleshoot and verify record propagation.

### List of hosting sites with Agency Handy:

* [**Cloudflare**](/english/agencyhandy-user-guide-for-agency/workspace-config/set-up-custom-domain/agencyhandy-hosting-with-cloudflare.md)
* Namecheap


---

# Agent Instructions: 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:

```
GET https://docs.agencyhandy.com/english/agencyhandy-user-guide-for-agency/workspace-config/set-up-custom-domain.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.