> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Custom Domain for Portal

> Guide to point custom domain to White Label portal and configure DNS records to verify and enable SSL.

**Custom Domain** allows you to point your own business domain or subdomain to the portal workspace. This setup ensures that your clients access and use the portal completely under your custom domain instead of the platform's default URL.

You can configure your custom domain under the **SaaS > Custom Domain** section on the left menu.

<Frame>
  <img src="https://mintcdn.com/chatbotx/y4XCvxB6edneQ8nL/images/chatbotx_whitelabel_custom_domain_entry.png?fit=max&auto=format&n=y4XCvxB6edneQ8nL&q=85&s=302f5fe046fa9a002eb7a91f46e6f8eb" alt="Chatbotx Whitelabel Custom Domain Entry" width="1589" height="1214" data-path="images/chatbotx_whitelabel_custom_domain_entry.png" />
</Frame>

## Custom Domain Setup Process

To activate your custom domain, follow these steps:

<Steps>
  <Step title="Add your domain">
    In the **Domain** field, enter your domain or subdomain name and click the **Add domain** button.
  </Step>

  <Step title="Retrieve DNS records">
    Once added, the domain status will show as **pending**. The system will generate three DNS records that you need to configure.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/y4XCvxB6edneQ8nL/images/chatbotx_whitelabel_custom_domain_pending.png?fit=max&auto=format&n=y4XCvxB6edneQ8nL&q=85&s=1a35e3cc68ca79d3fbd59bd72a8a7846" alt="Chatbotx Whitelabel Custom Domain Pending" width="2040" height="1219" data-path="images/chatbotx_whitelabel_custom_domain_pending.png" />
    </Frame>
  </Step>

  <Step title="Configure records at your DNS provider">
    Log in to your domain registrar or DNS management portal and add the following three records:

    * **CNAME Record**: Point your domain to `proxy-fallback.chatconnectx.com`. For root domains, your DNS provider might require you to use an ALIAS or ANAME record instead of CNAME.
    * **First TXT Record**: Input the Host name and value provided to verify your domain ownership.
    * **Second TXT Record**: Used to verify and provision your SSL security certificate (the value displays as `Creating...` during initialization).

    All three records are mandatory for the system to verify the domain and issue a secure SSL certificate.
  </Step>

  <Step title="Verify your domain">
    After adding the records, return to your Portal admin page and click **Verify now**.

    DNS propagation typically takes a few minutes, but can take up to 24 to 48 hours depending on your domain registrar.
  </Step>

  <Step title="Complete activation">
    Once DNS records are successfully verified, the domain status badge changes to a green **active** label with the verification date. Clients can now access the portal using this new domain.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/y4XCvxB6edneQ8nL/images/chatbotx_whitelabel_custom_domain_active.png?fit=max&auto=format&n=y4XCvxB6edneQ8nL&q=85&s=804a14a9b1c31c508b5e3cd6eb36ca8d" alt="Chatbotx Whitelabel Custom Domain Active" width="1238" height="1181" data-path="images/chatbotx_whitelabel_custom_domain_active.png" />
    </Frame>
  </Step>
</Steps>

## Changing or Removing a Domain

If you need to change your domain, simply click the red **Remove domain** button. This action removes the current domain immediately and allows you to configure a new one.