If you want to see how themes can look like check our free themes category.

As with every open source project everyone wan't to change something. We have option to style pretty much everything directly from back office. We can do following things

  • Change widget style
  • Change back office style
  • Have personal themes

Theming window

Widget themes has few sections. I'll try in short term describe what you can do in each of them.

Status widget style

Here you can change main widget attributes. Like logo etc.


Some of these attributes are quite old and not used anymore. They will be removed in old version.

Widget container

Here you can change general outlook of widget. Like borders padding etc.

Widget header background color

Sets background color for widget header

Widget border color

Border color for the widget

Widget border width (px)

Border width for the widget

Header height (px)

If you want higher header you can set it's height here.

Header padding (px)

Set custom padding for widget header

Widget width (px)

Override widget width directly from a theme

Widget height (px)

Override widget height directly from a theme

Minimize image | Only for a legacy widget

Image used to minimize the widget

Restore image | Only for a legacy widget

Close image | Only for a legacy widget

Popup image | Only for a legacy widget

Widget response layout width trigger (px) | Only for a legacy widget

Hide widget close button

You can hide close button in header by checking this.

Hide popup option

Hides popup option from header dropdown menu.

Try to detect language from browser headers

Widget will try to detect language by visitor browser and show language in his native langauge.

See youtube video how to setup it.

Things to check if it does not work.

  • Make sure you checked this checkbox
  • Make sure your browser sends correct language headers while testing.
  • Take a look at System configuration -> Speech -> Languages. Make sure Siteaccess column has a proper value.

Show go to survey button on chat close

Usually when chat is closed visitor is automatically redirected to survey. Instead of that you can show him Go to survey button just.

Before closing chat ask user does he really want to to close chat

Visitor will be asked for confirmation does he really want's to close a widget.

Close chat if page is refreshed. Usefull if you have embed code in popup.

If you have embeded Live Helper Chat script in popup it makes sense on popup close also close the chat.

After how many user messages show switch to human button. empty - never, 0 - always

If you want to give easy way for a visitor to be transferred to operator you can enable this option.

This option is always shown and does not pay attention is there any operator at the moment in back office. So most logical way is just to use bot workflow itself as it can check is there any operators online.

Messages style

Here you can change how message style looks like for visitor.

Need help widget

You can change how need help widget looks like.


This is not yet supported in new a widget.

Chat widget

Here you can change default text in widget itself.

Custom content

You can write custom HTML above start chat form fields.

Custom CSS

If you want to style form directly using CSS you can use this section.

Custom bot style

You can change default bot buttons style.


If you are using notifications functionality you should set logo and notification details here.


I have created a theme, how can I share it with community?

Community Themes will be published in github.

How do I apply theme?

You can either set default theme in back office or you can choose theme in embed code generation window.

How do I import a theme?

Navigation to

"System configuration" -> "Live help configuration" -> "Import new theme"

In this window just upload a new theme.

How do I apply imported theme, set the default one?

  • You can set default theme in

    Configuration -> Live Chat configuration -> Default theme

  • Also you can apply themes individually to embed code by selecting combobox in widget generation window. So you can just choose which theme widget should use.

How do I pass theme to start chat window?

Theme argument is /(theme)/<theme_id> so you can just manually write what theme should use. E.g index.php/chat/start/(theme)/2

I have created a theme and want to share with community where should I send a theme file?

Just send it to me.


In order operator to be able edit themes, set default theme he has to have this permission

'lhtheme', 'administratethemes'

Last updated on by Remigijus Kiminas