Customize Colors with the Service Chat SDK

You can customize the look and feel of the interface by specifying the colors used throughout the UI.

important: The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to Messaging for In-App and Web before that date. Messaging offers many of the chat features that you love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in Help.

To customize the colors, create color resource values in your project's colors.xml file that correspond to the same resource names specified in this documentation.

For example, the following resource file values customize some of the branding tokens:

<resources>
  <color name="salesforce_brand_primary">#50e3c2</color>
  <color name="salesforce_brand_secondary">#4a90e2</color>
  <color name="salesforce_contrast_inverted">#ffffff</color>
  <color name="salesforce_contrast_primary">#333333</color>
  <color name="salesforce_contrast_secondary">#767676</color>
  <color name="salesforce_feedback_primary">#e74c3c</color>
</resources>

These screenshots illustrate how the branding tokens affect the UI.

Chat UI Branding:

Branding colors for Chat

The following branding tokens are available for customization.

Token Name	Default Value	Description / Sample Uses
Toolbar<br>`salesforce_toolbar`	#FAFAFA	The toolbar background color.
Toolbar Inverted<br>`salesforce_toolbar_inverted`	#010101	Toolbar text and icon color.
Brand Primary<br>`salesforce_brand_primary`	#007F7F	The banner background color. Chat: Line under the message you’re typing.
Brand Secondary<br>`salesforce_brand_secondary`	#2872CC	Chat: User text bubbles.
Brand Contrast<br>`salesforce_brand_contrast`	#FCFCFC	Title text color.
Contrast Primary<br>`salesforce_contrast_primary`	#000000	Primary body text color.
Contrast Secondary<br>`salesforce_contrast_secondary`	#6D6D6D
Contrast Tertiary<br>`salesforce_contrast_tertiary`	#BABABA
Contrast Quaternary<br>`salesforce_contrast_quaternary`	#F1F1F1	Chat: Background color for the chat feed screen.
Contrast Inverted<br>`salesforce_contrast_inverted`	#FFFFFF	Page background, navigation bar, table cell background. Chat: Color of the close button on the minimized view. Client message text. Background color at the bottom of the input bar on the chat feed UI.
Feedback Primary<br>`salesforce_feedback_primary`	#E74C3C	Text color for error messages.
Feedback Secondary<br>`salesforce_feedback_secondary`	#2ECC71
Feedback Tertiary<br>`salesforce_feedback_tertiary`	#F5A623
Title Color<br>`salesforce_title_color`	#FBFBFB	Text as it appears in titles throughout the UI. Text on areas where a brand color is used for the background. Chat: Agent text bubbles.
Overlay<br>`salesforce_overlay`	#000000(40% alpha)