{"versionId":"76e15e52-48ba-4d58-e53a-08dee389699b","articleId":"6e1f7504-476f-4438-deb2-08dee6c29b03","title":"Chat widget styling: custom CSS","tags":["callouts","setup","styles","All articles"],"content":"

Use custom CSS to make styling changes to your Helpfruit chat widget beyond the standard options for avatar, colours, and position. This article covers commonly used selectors and example CSS snippets for common styling changes.

Quick links

Add custom CSS
Frequently used CSS selectors
Callout selectors
Example CSS snippets\n
- Always show the close button
- Hide the callout on small screens
- Change widget width
- Change chat content height
- Round widget corners
- Style bot messages
\n
Tips for testing changes

Add custom CSS

Go to Configuration > Bot styles, then open the Custom CSS tab.

Use this area to add styling changes that are not available in the standard widget styling options.

Some styles may only apply if you add !important. After saving your changes, test the widget on desktop and mobile.

Frequently used CSS selectors

Use the selectors below to target common parts of the chat widget.

\n
#myChatButton — use this to style the chat button, including avatar sizing.
\n
\n
#chatBoxWrapper — the main wrapper for the chat widget. Use this to adjust width, borders, and outer styling.
\n
\n
#chatBoxWrapper .chatBoxContent — use this to adjust the height of the chat content area.
\n
\n
#chatBoxWrapper .chatBoxHeader — the header area of the chat widget.
\n
- \n
  .chatHeaderIcon span.icon — the header icon.
  \n
- \n
  .chatHeaderTitle h1 — the header title.
  \n
\n
\n
#chatBoxWrapper .wc-message-from-bot .wc-message-content — bot message styling.
\n
\n
#chatBoxWrapper .wc-message-from-me .wc-message-content — user message styling.
\n
\n
#chatBoxWrapper .chatBoxContent .wc-chatview-panel .wc-console — the chat input area.
\n
- \n
  button.wc-send — the send button.
  \n
\n

Callout selectors

Use these selectors to style callouts.

\n
.callout-close-wrapper
\n
\n
.callout-message
\n
\n
.callout-message-triangle
\n
\n
.callout-message-triangle-shadow
\n

Example CSS snippets

Always show the close button

/* Always show the close button */\n.callout-close-wrapper {\n  opacity: 100 !important;\n}

Hide the callout on small screens

@media screen and (max-width: 400px) {\n  .callout-message {\n    display: none;\n  }\n\n  .callout-message-triangle {\n    display: none;\n  }\n\n  .callout-message-triangle-shadow {\n    display: none;\n  }\n\n  #myChatButton {\n    bottom: 2vh;\n  }\n}

Change widget width

#chatBoxWrapper {\n  width: 420px !important;\n}

Change chat content height

#chatBoxWrapper .chatBoxContent {\n  height: 500px !important;\n}

Round widget corners

#chatBoxWrapper,\n#myChatButton {\n  border-radius: 16px !important;\n}

Style bot messages

#chatBoxWrapper .wc-message-from-bot .wc-message-content {\n  background-color: #f3f4f6 !important;\n  color: #111827 !important;\n}

Tips for testing changes

\n
Save one change at a time so it is easier to spot problems.
\n
\n
Test the widget on desktop and mobile screen sizes, on your website test environment - so you can see how it works with your site's CSS.
\n
\n
Check the chat button, header, messages, input area, and callouts.
\n
\n
If a style does not apply, try adding !important.
\n
\n
Remove any CSS that causes layout or readability issues.
\n

","description":"Use custom CSS to make advanced styling changes to your Helpfruit chat widget, including layout, spacing, borders, and callout behaviour.","isMarkdown":false,"publishedOnUtc":"2026-10-16T02:16:17.28467","modifiedOnUtc":"2026-07-23T05:08:07.4770124"}