# Customize Colors with the Service Chat SDK
Customize the colors by defining the branding token colors used throughout the interface.
:::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 colors, create an `SCAppearanceConfiguration` instance, specify values for each token you want to change, and store the instance in the [`appearanceConfiguration`](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCServiceCloud.html#/c\:objc\(cs\)SCServiceCloud\(py\)appearanceConfiguration) property of the [`ServiceCloud`](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCServiceCloud.html) [`sharedInstance`](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCServiceCloud.html#/c\:objc\(cs\)SCServiceCloud\(cm\)sharedInstance).
In Swift:
```java
// Create appearance configuration instance
let appearance = SCAppearanceConfiguration()
// Customize color tokens
appearance.setColor(COLOR_VALUE, forName: TOKEN_NAME)
// Add other customizations here...
// Save configuration instance
ServiceCloud.shared().appearanceConfiguration = appearance
```
In Objective-C:
```java
// Create appearance configuration instance
SCAppearanceConfiguration *appearance = [SCAppearanceConfiguration new];
// Customize color tokens
[appearance setColor:COLOR_VALUE forName:TOKEN_NAME];
// Add other customizations here...
// Save configuration instance
[SCServiceCloud sharedInstance].appearanceConfiguration = appearance;
```
To support dark mode in iOS 13 and later, [specify adaptive colors](https://github.com/forcedotcom/ServiceSDK-iOS/wiki/Handling-Dark-Mode-for-iOS-13-with-the-Service-SDK) for each branding token. The following branding tokens are available for customization.
| Token Name / Swift Value / Objective-C Value | Default | Dark Mode Default | Description / Sample Uses |
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| Navigation Bar Background
`navbarBackground`
`SCSAppearanceColorTokenNavbarBackground` | #FAFAFA  | #1A2129  | Background color for the navigation bar. |
| Navigation Bar Inverted
`navbarInverted`
`SCSAppearanceColorTokenNavbarInverted` | #010101  | #C6CBCF  | Navigation bar text and icon color. |
| Brand Primary
`brandPrimary`
`SCSAppearanceColorTokenBrandPrimary` | #007F7F  | #00B4B4  | |
| Brand Secondary
`brandSecondary`
`SCSAppearanceColorTokenBrandSecondary` | #2872CC  | #0070D2  | Used throughout the UI for button colors. Chat: Agent text bubbles. |
| Primary Brand Inverted
`brandPrimaryInverted`
`SCSAppearanceColorTokenBrandPrimaryInverted` | #FBFBFB  | #FBFBFB  | |
| Secondary Brand Inverted
`brandSecondaryInverted`
`SCSAppearanceColorTokenBrandSecondaryInverted` | #FCFCFC  | #F7F7F7  | Text on areas where a brand color is used for the background. |
| Contrast Primary
`contrastPrimary`
`SCSAppearanceColorTokenContrastPrimary` | #000000  | #E2E4E6  | Primary body text color. |
| Contrast Secondary
`contrastSecondary`
`SCSAppearanceColorTokenContrastSecondary` | #6D6D6D  | #898D92  | |
| Contrast Tertiary
`contrastTertiary`
`SCSAppearanceColorTokenContrastTertiary` | #BABABA  | #A0A6AD  | |
| Contrast Quaternary
`contrastQuaternary`
`SCSAppearanceColorTokenContrastQuaternary` | #F1F1F1  | #09121B  | Chat: Background color. |
| Contrast Inverted
`contrastInverted`
`SCSAppearanceColorTokenContrastInverted` | #FFFFFF  | #323232  | Page background, navigation bar, table cell background. |
| Feedback Primary
`feedbackPrimary`
`SCSAppearanceColorTokenFeedbackPrimary` | #E74C3C  | #E0A7A9  | Text color for error messages. |
| Feedback Secondary
`feedbackSecondary`
`SCSAppearanceColorTokenFeedbackSecondary` | #2ECC71  | #9ACDB7  | |
| Feedback Tertiary
`feedbackTertiary`
`SCSAppearanceColorTokenFeedbackTertiary` | #F5A623  | #FADBAE  | |
| Overlay
`overlay`
`SCSAppearanceColorTokenOverlay` | Contrast Primary (at 40% alpha) | #323232  | |
These screenshots illustrate how the branding tokens affect the UI.
Chat UI Branding:
## Example
The following code sample changes three of the branding tokens.
In Swift:
```java
// Create appearance configuration instance
let appearance = SCAppearanceConfiguration()
// Customize color tokens
appearance.setColor(
UIColor(red: 80/255, green: 227/255, blue: 194/255, alpha: 1.0),
forName: .brandPrimary)
appearance.setColor(
UIColor(red: 74/255, green: 144/255, blue: 226/255, alpha: 1.0),
forName: .brandSecondary)
appearance.setColor(
UIColor(red: 252/255, green: 252/255, blue: 252/255, alpha: 1.0),
forName: .brandSecondaryInverted)
// Save configuration instance
ServiceCloud.shared().appearanceConfiguration = appearance
```
In Objective-C:
```java
// Create appearance configuration instance
SCAppearanceConfiguration *appearance = [SCAppearanceConfiguration new];
// Customize color tokens
[appearance setColor:[UIColor colorWithRed: 80/255
green: 227/255
blue: 194/255
alpha: 1.0]
forName:SCSAppearanceColorTokenBrandPrimary];
[appearance setColor:[UIColor colorWithRed: 74/255
green: 144/255
blue: 226/255
alpha: 1.0]
forName:SCSAppearanceColorTokenBrandSecondary];
[appearance setColor:[UIColor colorWithRed: 252/255
green: 252/255
blue: 252/255
alpha: 1.0]
forName:SCSAppearanceColorTokenBrandSecondaryInverted];
// Save configuration instance
[SCServiceCloud sharedInstance].appearanceConfiguration = appearance;
```
For an example of how to specify adaptive colors that work with the dark mode feature that was introduced in iOS 13, see [Handling Dark Mode for iOS 13 with the Service SDK](https://github.com/forcedotcom/ServiceSDK-iOS/wiki/Handling-Dark-Mode-for-iOS-13-with-the-Service-SDK).