# Add a custom knowledge base domain

> Your Kustomer knowledge base comes hosted on an internal URL (brand.kustomer.com) provided by us. You can use a branded domain, such as,  support.brand.com.

Source: https://help.kustomer.com/en_us/custom-knowledge-base-domain-S1TQuULb8

Last updated: 2026-07-01T20:35:06.481Z

Your Kustomer knowledge base comes hosted on an internal URL (brand.kustomer.com) provided by us. You can use a branded domain, such as, [support.brand.com](//support.brand.com), to provide a better experience for your users, and help your Knowledge Base content rank higher in search engines. Domains can be purchased from organizations like GoDaddy, 1&1, Register.com, or Domain.com. You will retain full control and ownership of your domain while it is pointed to your Kustomer knowledge base. 

We automatically provision an SSL certificate for the domain, so you do not need to bring your own.

**Who can access this feature?**

**User types**

Admins and content administrators have access to knowledge base configuration settings.

  

### In this article

*   [Add your custom domain](#Adding)
*   [Obtain your certificate](#Obtaining)
*   [Reset or delete your custom domain](#ResetDelete)
*   [Update your DNS](#Updating)

### Add your custom domain

To add your custom domain in Kustomer:

1.  Go to **Settings** ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/bb46805c4c3bb5b9583f4df73b443203.png) **\> Knowledge Base >** **Configuration**.
2.  Select the brand you are configuring the custom domain for from the drop-down menu.
3.  Enter your domain as you have provisioned it from the domain provider. Ensure the proper spelling so that you do not have to start the certification process over. Please note, you should not enter the primary domain of your website and instead use a branded subdomain such as _help.**yourcompany**.com_.  
    ![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/21a5d647bf84b5efd80c3b6d9de1553e.png)
4.  Select **Add** to start the certification process.

### Obtain your certificate

The certification process starts once you've added your domain. The Certification box will appear below your domain and provide you with the required CNAME information you need. This information will need to be added to your domain in whichever provider you used to provision it.

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/dc34b7688af41d2d5f6cbf3b1cfa3fa0.png)

You may see the following status codes once this process starts:

*   Pending Validation - Our system is creating the proper CNAME information for your Knowledge Base brand.
*   Issued - Our system has provisioned the proper CNAME information and it is now available to you.
*   Failed - Our system was unable to provision the information for you. You will need to delete your domain and try again.
*   Inactive 
*   Expired
*   Validation Timed out
*   Revoked

### 

#### Advanced troubleshooting: CAA record errors

Some domains use Certification Authority Authorization (CAA) DNS records to control which certificate authorities can issue SSL certificates for the domain. Your technical team will need to determine whether your DNS settings include CAA records. Kustomer Support can’t manage your DNS settings or update CAA records on your behalf.

If certificate validation fails and your DNS settings include CAA records, update your DNS settings to authorize Amazon to issue the certificate. Add the following CAA records for your domain at minimum:

Type

Flag

Tag

Value

CAA

0

issue

amazon.com

CAA

0

issue

amazontrust.com

  
After adding the CAA records, wait for DNS propagation to complete. Propagation time depends on your DNS provider and TTL settings.

Once the records have propagated, return to **Settings > Knowledge Base > Configuration** and then reset, or delete the failed certificate request and then re-add the custom domain to request a new certificate.

### Reset or delete your custom domain

You can reset the domain certificate or completely remove your custom knowledge base domain directly from within Kustomer by selecting the desired action. 

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/bd586296ee5c411ea71ac58f52e92e6c.png)

You can only reset a custom domain if the certification approval status is one of the following states:

*   Pending Validation
*   Failed
*   Inactive 
*   Expired
*   Validation Timed out
*   Revoked

**Note:** You cannot reset a domain certificate once it's been issued. The only option will be to delete it from Kustomer.  
  

After you reset or delete your domain, select **Confirm** in the confirmation window that opens.

### Update your DNS

Once your certification is issued, you can navigate to the DNS tab in the same table. The information in this table is what you will use to redirect your custom domain to Kustomer. 

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/3060f1b4ce6f640967d77ffc1f6c1aeb.png)

1.  Copy the Record field, which will be a [cloudfront.net](//cloudfront.net) URL.
2.  Log in to your custom domain's settings page. 
3.  Update your domain's DNS by replacing the CNAME record with the above URL. You can find instructions on how to set up redirects for providers such as, [godaddy.com](https://www.godaddy.com/help/change-a-cname-record-19237) and [google.com](https://support.google.com/a/answer/47283?hl=en), here.

Once that is complete, you will see the following statuses:

*   **Deployed** - You have successfully connected your domain
*   **In Progress** - Our system is still verifying the correct setup

This is the final part of the setup and it may take up to 72 hours for your domain to propagate your knowledge base content.

**Note:** If you encounter any issues configuring or validating your custom knowledge base domain, check out our help article [Domain validation flow and troubleshooting](https://help.kustomer.com/domain-validation-flow-and-troubleshooting-SJEErGxLo).
