Overview

It is possible to customize the look of the chat widget (both the icon and the chat itself) by modifying the CSS rules for classes used for chat HTML elements. 

The methods to do it are different for chats placed on the customer portal and on the external web sites. In both cases, it is necessary to have a knowledge of CSS and to have some HTML inspection tools available (the ones built into browsers, like Chrome Developer Tools or Firefox Developer Tools can be used).

When customizing the style, you will often have to use the !important CSS keyword to force your modifications, because the chat uses deeply specific CSS rules, to prevent leaking its styles into parent page's HTML content.

Customer Portal


In the customer portal, it is impossible to directly modify the portal's HTML source code, so when placed there, chat adds two classes to its elements:

  • support-chat-sd-icon-class to the chat icon
  • support-chat-sd-chat-class to the toplevel element of the chat itself

Using the Settings → Chat → Translate and Customize ("Customize Appearance on Service Desk Portal" tab), you can insert CSS rules that you define into the portal pages. This is done in the Icon CSS and Chat CSS input boxes:

For example, to change the color of the chat icon to darkcyan, provide the following in the Icon CSS box:

.support-chat-sd-icon-class{
	background-color: darkcyan !important;
}

This will result in the change in appearance of the chat icon on the customer portal:



In the customer portal, you can set up how the chat button will look like. You can select one of the built-in styles ("normal" and "subtle"), or you can define your own style of the button, setting the text and background color. Note that the custom button style does not display chat icon. 

You can also define the dominant color of the chat widget itself

Cloud version of chat allows setting the customizations of the look of the chat widget in each project separately, in the Project Settings page.


External Web Sites

On external web sites, the way to customize appearance of the chat differs - it is based on the snippet of HTML code placing the widget on the web site, paired with CSS rules placed on the page.

For example, to change the icon color to darkcyan, add the following to your web page where you placed the chat widget:

Add iconClass to the chat configuration Javascript:

var spartezSupportChat = {
        url: 'https://jira.spartez.com',
        portal: 2,


		// ######## ADDED ############
        iconClass: 'my-chat-icon-class'
		// ######## END OF ADDED #####
    }

Add CSS rules:

.my-chat-icon-class.support-chat-icon {
	background-color: darkcyan !important;
}