> For the complete documentation index, see [llms.txt](https://docs.stammer.ai/stammer.ai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stammer.ai/stammer.ai-docs/chat-ai-agents/ai-chat-widget/customize-chat-widget-apperance.md).

# Customize Chat Widget Apperance

This allows you to full customize the look, color, appearance and feel of the embeddable chat widget.

To customize the appearance of your AI agent's chat widget, click into any AI agent and then navigate to the Appearance tab. Here you will see a whole suite of options to customize pretty much every aspect of the chat widget. 

On the right hand side there is a live preview of what your changes will look like. 

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FqaZW5qTBk85m6R73Ij1c%2FScreenshot%202024-07-03%20at%203.10.24%E2%80%AFPM.jpg?alt=media&amp;token=9b21f233-3da8-4259-9760-190b73efb4c6" alt=""><figcaption></figcaption></figure>

## Font Size

Font size for the chat text in pixels.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FRsmz4oj0AG65CV4t9Ue9%2FScreenshot%202024-03-08%20at%203.56.45%E2%80%AFPM.jpg?alt=media&amp;token=debae981-8918-435d-91de-be7d90a68f99" alt=""><figcaption></figcaption></figure>

## Font Family

Font family for the chat text.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FhhjLCtEgMN4hgfcTPbGy%2FScreenshot%202024-03-08%20at%203.57.33%E2%80%AFPM.jpg?alt=media&amp;token=b36a1da4-0590-42b7-9d81-8379bb9c3d3f" alt=""><figcaption></figcaption></figure>

## Subheading

Subheading for the chat widget, such as 'Online', 'Available', etc.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FNm0KMoe6mseNGn7lSVdn%2FScreenshot%202024-03-08%20at%203.58.41%E2%80%AFPM.jpg?alt=media&amp;token=44d4a2c2-361e-4e05-ba37-d40826c7980e" alt=""><figcaption></figcaption></figure>

## Chatbot Icon

Displayed in the chat widget header as the chatbot image.

Supported file extensions are png, jpg, jpeg and Ideal logo size is 32x32 pixels.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2Fi4euDz5rglRdQMwMUegl%2FScreenshot%202024-03-08%20at%203.59.35%E2%80%AFPM.jpg?alt=media&amp;token=5699fe82-5f75-46dd-a781-e2b5f3f77cff" alt=""><figcaption></figcaption></figure>

## Chat Input Placeholder

Enter the text that will be displayed as a hint in the chat input field.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FaNqaQjzsCF9L3RwShXSg%2FScreenshot%202024-03-08%20at%203.59.54%E2%80%AFPM.jpg?alt=media&amp;token=f3b42b3b-e6d8-4543-9b54-49345ee4d0a1" alt=""><figcaption></figcaption></figure>

## Send Message Button

Upload a custom send message button. Defaults to a standard button if not provided. Supported file extensions are png, jpg, jpeg and Ideal logo size is 32x32 pixels.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FA54KugNPRk2MuIk3HifQ%2FScreenshot%202024-03-08%20at%204.10.33%E2%80%AFPM.jpg?alt=media&amp;token=cbbe4bfa-19ce-41b0-a226-72b1788b62f7" alt=""><figcaption></figcaption></figure>

## Customize Colors

This section allows you to customize all the different colors of the platform.&#x20;

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FB1PEtKKiBX9ou26l4D4D%2FScreenshot%202024-03-08%20at%209.01.37%E2%80%AFPM.jpg?alt=media&amp;token=b280aee2-8b20-4556-a47e-19f637c61f8f" alt=""><figcaption></figcaption></figure>

## Widget Boarder

Border radius of the widget in pixels.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FPGhV6x3MphZOc0fel4eM%2FScreenshot%202024-03-08%20at%209.04.16%E2%80%AFPM.jpg?alt=media&amp;token=1e426d98-22c1-4db0-9da5-bd967909b65b" alt=""><figcaption></figcaption></figure>

## Widget Background

Widget Background Preference

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2F9sgMqqIIJ1cMitPwM48v%2FScreenshot%202024-03-08%20at%209.04.47%E2%80%AFPM.jpg?alt=media&amp;token=446b9cb0-6cd4-40fc-a9c8-d0ed4b9beaf1" alt=""><figcaption></figcaption></figure>

## Size of the Chat Widget

Adjust the size of the chat widget to me small, medium or large.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FiGHfjbPgOiFaFH34Y77r%2FScreenshot%202025-03-21%20at%201.59.35%E2%80%AFPM.jpg?alt=media&amp;token=4d52a035-9764-40c0-824d-42c39d7a31e3" alt=""><figcaption></figcaption></figure>

## Tagline

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FseYqkIKk7vNcy0likTky%2FScreenshot%202024-03-08%20at%209.06.35%E2%80%AFPM.jpg?alt=media&amp;token=093e33ad-7f2a-44f5-89df-3b182a03e060" alt=""><figcaption></figcaption></figure>

## Chat Bubble Icon

This is the icon that appears on your site before a user clicks to open the chat.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2F2LKZakA6gujcCXtr29A6%2FScreenshot%202024-03-08%20at%209.06.57%E2%80%AFPM.jpg?alt=media&amp;token=8012776b-224b-4e45-95a3-1e9d3b413a07" alt=""><figcaption></figcaption></figure>

## AI Agent Status Messages

Enable to show status messages from the AI agent in the chat widget which are displayed to the user while the AI is processing a response.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FTaDR1RLbjshESoUdDiwg%2FScreenshot%202024-03-08%20at%209.07.27%E2%80%AFPM.jpg?alt=media&amp;token=ee2b1684-3da3-4168-b760-9652cba263cc" alt=""><figcaption></figcaption></figure>

## Chat Avatar Icon

This image appears inside the chat window next to your bot’s messages.

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FbmI0NhXngfBV7Oa9f0oA%2FScreenshot%202025-04-25%20at%2011.16.30%E2%80%AFAM.jpg?alt=media&amp;token=bb7604d1-8d0c-4731-a224-04e03eb2608b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1359281993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLIQnOFYHkQtdWxUzzFE%2Fuploads%2FLdhWCS5dAhat96zE2FRs%2FScreenshot%202025-04-25%20at%2011.16.34%E2%80%AFAM.jpg?alt=media&amp;token=994334f4-5569-4ef4-b76c-d539eb3efa3c" alt=""><figcaption></figcaption></figure>