---
title: Connect to subdomain & customize branding
sidebar_label : Knowledge base
---

After creating a [knowledgebase](https://docs.yellow.ai/docs/platform_concepts/inbox/knowledge-base/kboverview) on Inbox, you can customize it's look and feel on the Knowledgebase(KB) settings page and manage your site's name, URL, favicon, and more.

In this article, you will learn:
1. [How to add knowledgebase website's title and default language?](#title)
2. [How to connect Knowledge base to a custom subdomain?](#domain)
3. [How to customize knowledgebase website's banner branding?](#brand)

---

## <a name="title"></a> 1. Set KB site title and default language

Follow the below steps to add the knowledgebase website's title and set the default language:

1. Go to **Inbox** > **Settings**. Search and select **Knowledge base settings**.
2. Enter the **Site title**.


3. Click **Save**. Open your URL on a new tab, on top of the browser, you can see the updated site title .

<img src="https://i.imgur.com/Fr1Ix61.png" alt="drawing" width="70%"/>

4. The **Help site language** (default language) can be selected from the dropdown based on the language that would support customers to browse for the documentation. All the **static variables** (example, default text on the site like *Search or Explore knowledgebase*) will get updated to the selected language.

> Languages supported currently: **English, Polish, Czech, Slovakian, Romanian**.


---

## <a name="domain"></a> 2. Connect Knowledge base to a subdomain

Businesses generally host their knowledge base within their website to make it easier for their customers to access.

> For example, [docs.yellow.ai](https://docs.yellow.ai/) is the official knowledge base for all Yellow.ai products.

To hosted the knowledge base in your custom domain, follow the steps below:

1. Go to **Inbox** > **Settings**. Search and select **Knowledge base settings**.


:::note
Every Inbox account has a free autogenerated subdomain provided by Yellow.ai where the knowledge base articles will be hosted.
**Knowledgebase website format:** ```https://<botname>.kb.botplatform.io```
:::

2. To connect to an external subdomain, click **Connect a custom domain**.


3. Click **Next**.


4. Enter your company's URL.


5. Once the **CNAME record** is generated, copy & add this record to your domain configuration page on the domain registrar.


:::info

The place to add these records will vary based on which domain hosting service you use. Following are the links for the common domain registrars:

- [Bluehost - support article](https://www.bluehost.com/hosting/help/cname)
- [Cloudflare - support article](https://community.cloudflare.com/t/how-do-i-add-a-cname-record/59)
- [NameCheap - support article](https://www.namecheap.com/support/knowledgebase/article.aspx/434/2237/how-do-i-set-up-host-records-for-a-domain/)
- [GoDaddy - support article](https://in.godaddy.com/help/add-a-cname-record-19236)
- [Google domains - support article](https://support.google.com/a/answer/47283)
:::

6. If you unable to configuring this by yourself, click the **Share with tech team** button, copy the content shown and send it to your teach team for support.


7. After adding the record in your domain registrar, click **Submit & verify**. This will start the domain verification process.


8. Once the domain is verified, yellow.ai will issue a free SSL certification for that subdomain to protect your customer information from malicious damage. You can return to knowledgebase settings page to check if your domain is secured.

9. After the bot is live, you can choose to switch between free domain provided by Inbox or your custom domain by enabling or disabling the custom domain toggle.


#### Unpublish knowledgebase site

10. To unpublish your site or take the website down, click **Disable** on the top (site is published) banner. You can **Enabel** it whenever required.


---

## <a name="brand"></a> 3. Customize banner branding

Knowledge base is an extension of a main website, the business or the customer can customize knowledge base site in accordance with the businesses primary design and theme.
To customize the site’s banner, logo, and favicon, follow the steps below:

1. Go to **Inbox** > **Settings** > **Knowledge base settings**.
2. Click **Edit branding**.


3. You can customize the following:
- **Theme**: Select **Light theme** or **Dark theme** from the dropdown. This will be default theme for the site users even if their devices are set to a different theme.
- **Primary colour**: This colour will be applied to primary header elements like the navigation and buttons.
- **Primary text color**: This colour will be aplied to the text on the navigation and buttons.
- **Banner background**: You can upload an image or select a solid colour to be the banner background.
- **Help question and colour**. Enter a help question Ex: How can we help you, Search here, etc. Select the color of the help question text.
- **Link to your website**: Enter your website that will be visible on the header to redirect users to it after they finish using the documentation.
- **Logo and Favicon**: Upload square images (150x150) for Logo and Favicon. They will be visible on the sites title and website logo respectively.
- **Footer background**: You can upload an image or select a solid colour to be the footer background.
- **Footer text color**: Select the color for the footer text.
- **Contact info**: Footer text will contain info like: Still unsure about something? if you cannot find answer to your question here, you can always reach out to us at < Contact >. The contact info updated in this field will allow the customers to directly contact you(Phone number, website, email ID, etc) .

4. Click **Preview** to test the look and feel of the site and **Save** the changes.

<img src="https://i.imgur.com/jwuPt43.png" alt="drawing" width="70%"/>