---
schema_version: "1"
id: 14ec46f7d287ed9b1593831e46fefaf6f8510a48f9916b539b10fe683f9d2ef2
title: Customize Colors with the Service Chat SDK
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/service-sdk-android/guides/android-customize-colors.md
canonical_url: https://developer.salesforce.com/docs/service/service-sdk-android/guide/android-customize-colors.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 08831c29cdbea58e3adaa412c6bf769d71ccc1e961003a2957ecbc3657e2e439
products:
  - Embedded Service Chat SDK for Android Developer Guide
  - Service Cloud Developer Content
---

# 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](https://help.salesforce.com/s/articleView?id=service.miaw_intro_landing.htm&type=5) before that date. Messaging offers many of the [chat features](https://help.salesforce.com/s/articleView?id=service.miaw_chat_vs_messaging.htm&type=5) that you love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in [Help](https://help.salesforce.com/s/articleView?id=001790618&type=1).

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:

```xml
<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](https://developer.salesforce.com/docs/media/service-sdk/branding-chat-android.png '{"class": "image-md"}')

The following branding tokens are available for customization.

| Token Name                                              | Default Value                                                                                                     | Description / Sample Uses                                                                                                                                                                                |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Toolbar<br>`salesforce_toolbar`                         | #FAFAFA ![Toolbar](https://developer.salesforce.com/docs/media/service-sdk/branding_color_FAFAFA.png '{"class": "image-icon-lg"}')             | The toolbar background color.                                                                                                                                                                            |
| Toolbar Inverted<br>`salesforce_toolbar_inverted`       | #010101 ![Toolbar inverted](https://developer.salesforce.com/docs/media/service-sdk/branding_color_010101.png '{"class": "image-icon-lg"}')    | Toolbar text and icon color.                                                                                                                                                                             |
| Brand Primary<br>`salesforce_brand_primary`             | #007F7F ![Brand primary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_007F7F.png '{"class": "image-icon-lg"}')       | The banner background color. Chat: Line under the message you’re typing.                                                                                                                                 |
| Brand Secondary<br>`salesforce_brand_secondary`         | #2872CC ![Brand secondary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_2872CC.png '{"class": "image-icon-lg"}')     | Chat: User text bubbles.                                                                                                                                                                                 |
| Brand Contrast<br>`salesforce_brand_contrast`           | #FCFCFC ![Secondary inverted](https://developer.salesforce.com/docs/media/service-sdk/branding_color_FCFCFC.png '{"class": "image-icon-lg"}')  | Title text color.                                                                                                                                                                                        |
| Contrast Primary<br>`salesforce_contrast_primary`       | #000000 ![Contrast primary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_000000.png '{"class": "image-icon-lg"}')    | Primary body text color.                                                                                                                                                                                 |
| Contrast Secondary<br>`salesforce_contrast_secondary`   | #6D6D6D ![Contrast secondary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_767676.png '{"class": "image-icon-lg"}')  |                                                                                                                                                                                                          |
| Contrast Tertiary<br>`salesforce_contrast_tertiary`     | #BABABA ![Contrast tertiary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_BABABA.png '{"class": "image-icon-lg"}')   |                                                                                                                                                                                                          |
| Contrast Quaternary<br>`salesforce_contrast_quaternary` | #F1F1F1 ![Contrast quaternary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_F1F1F1.png '{"class": "image-icon-lg"}') | Chat: Background color for the chat feed screen.                                                                                                                                                         |
| Contrast Inverted<br>`salesforce_contrast_inverted`     | #FFFFFF ![Contrast inverted](https://developer.salesforce.com/docs/media/service-sdk/branding_color_FFFFFF.png '{"class": "image-icon-lg"}')   | 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 ![Feedback primary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_E74C3C.png '{"class": "image-icon-lg"}')    | Text color for error messages.                                                                                                                                                                           |
| Feedback Secondary<br>`salesforce_feedback_secondary`   | #2ECC71 ![Feedback secondary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_2ECC71.png '{"class": "image-icon-lg"}')  |                                                                                                                                                                                                          |
| Feedback Tertiary<br>`salesforce_feedback_tertiary`     | #F5A623 ![Feedback tertiary](https://developer.salesforce.com/docs/media/service-sdk/branding_color_F5A623.png '{"class": "image-icon-lg"}')   |                                                                                                                                                                                                          |
| Title Color<br>`salesforce_title_color`                 | #FBFBFB ![Primary inverted](https://developer.salesforce.com/docs/media/service-sdk/branding_color_FBFBFB.png '{"class": "image-icon-lg"}')    | 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)                                                                                                |                                                                                                                                                                                                          |
