> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.crisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to customize the Crisp Chatbox

*This article explains where to customize the Crisp chatbox and which settings are available.*

Crisp lets you adapt the chatbox to your brand by adjusting its colors, texts, behavior, position, and localized wording. Advanced customization now lives directly inside the chatbox settings, instead of in a separate Customization plugin.
---

# ${color}[#0080dd](Watch the chatbox customization walkthrough)

If you prefer a quick visual walkthrough, this video shows how to customize your Crisp chatbox, from basic appearance settings to texts, position offsets, and custom colors.

${youtube}[How to Customize Your Crisp Live Chat Widget](qvJ-kKTse28)
---

# ${color}[#0080dd](Open Advanced Chatbox Customization)

The dedicated Customization plugin interface has been replaced by the new chatbox customization experience. All chatbox customizations are now handled from the Crisp app settings. 

__To open the advanced customization menu:__
1. Go to [**Crisp**](https://app.crisp.chat)
2. Open **Settings → Chatbox Settings → Chatbox Appearance**
3. Go to **Chatbox Theme**
4. Open **Advanced Chatbox Customization**

|| Advanced customization is available on paid plans that include widget customization. The Free plan still includes simpler appearance settings such as predefined color themes.
---

# ${color}[#0080dd](What you can customize)

You can use the chatbox settings for basic changes, then open **Advanced Chatbox Customization** when you need deeper control over texts, theme details, and locale-specific wording.

__Common customization options include:__
* **Colors** → choose predefined colors or configure custom baseline colors from the advanced customization UI
* **Texts** → customize chatbox labels, system messages, welcome messages, and other visible wording
* **Locales** → define a default fallback locale and add localized text overrides per language
* **Behavior** → manage options such as the availability tooltip, privacy mode, mobile visibility, and homepage section
* **Position** → display the chatbox on the right or reverse it to the left side of your website
---

# ${color}[#0080dd](Use search and live preview)

The new customization interface includes a search input, so you can quickly find the exact setting or text you want to edit.

Changes can be previewed live on the real chatbox from the same UI. You no longer need to leave the customization screen or save repeatedly just to check how a text or theme change will look.
---

# ${color}[#0080dd](Customize colors)

Color management has been simplified. Instead of manually adjusting many related colors, you now pick the main baseline colors and Crisp automatically generates the lighter and darker variants used by the chatbox.

If you set a custom color, the chatbox settings will prevent switching back through the predefined color picker and will direct you to **Advanced Chatbox Customization** instead. This keeps custom color setups consistent and avoids overwriting advanced theme settings by mistake.
---

# ${color}[#0080dd](Customize texts per locale)

Chatbox texts can now be localized. Start by editing the **Default** locale, which acts as the fallback, then add specific locales when you want different wording per language.

This is especially useful for multilingual websites, as visitors can see chatbox texts that match the language they are browsing in.

|| If you use Telegram, the chatbox welcome message does not apply in the same way. Telegram conversations start from the visitor first message and follow the channel flow.
---

# ${color}[#0080dd](Good articles to continue)

__Useful customization guides:__
* **Welcome message** → [change the greeting shown when visitors open the chatbox](https://help.crisp.chat/en/article/how-to-change-the-chatbox-welcome-message-1ja9m16/)
* **Chatbox color** → [adjust your chatbox color theme](https://help.crisp.chat/en/article/how-to-change-the-chatbox-color-1txcz7t/)
* **Chatbox language** → [control the language displayed in the widget](https://help.crisp.chat/en/article/how-to-change-the-chatbox-language-1snv3e4/)
* **Chatbox position** → [move the widget to the left side](https://help.crisp.chat/en/article/how-to-change-to-chatbox-position-to-the-left-18gl9y0/)