---
schema_version: "1"
id: 4245571b3438a2d06a44661f6e1a7efa740dadd7d9a832aea5a100ee7ba0e7a0
title: Customize Images 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-ios/guides/customize-images.md
canonical_url: https://developer.salesforce.com/docs/service/service-sdk-ios/guide/customize-images.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 795b7945fb8d018057c0a42a0b0012608a8f2a288fdec7e9a910870f5e999a7b
products:
  - Embedded Service Chat SDK for iOS Developer Guide
  - Service Cloud Developer Content
---

# Customize Images with the Service Chat SDK

You can specify custom images 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).

Use the [`setImage`](https://developer.salesforce.com/docs/service/service-sdk-ios/guide/%3Chttps://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCAppearanceConfiguration.html#/c:objc(cs)SCAppearanceConfiguration(im)setImage:compatibleWithTraitCollection:forName:>) method on the [`SCAppearanceConfiguration`](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCAppearanceConfiguration.html) object to **replace a stock image** with your image. Use the enumeration value for the image you intend to replace.

Supported image file formats include: tiff, tif, jpg, jpeg, gif, png, bmp, BMPF, ico, cur.

For specific images, use the `SCSAppearanceImageToken` enumeration specified by the SDK and add it to the [`SCAppearanceConfiguration`](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCAppearanceConfiguration.html) object with the [`setImage`](https://developer.salesforce.com/docs/service/service-sdk-ios/guide/%3Chttps://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCAppearanceConfiguration.html#/c:objc(cs)SCAppearanceConfiguration(im)setImage:compatibleWithTraitCollection:forName:>) method.

| Image Description                                                                              | Enum Value                  |
| ---------------------------------------------------------------------------------------------- | --------------------------- |
| Close button                                                                                   | `close`                     |
| Done button                                                                                    | `done`                      |
| Small warning icon used when an error occurs                                                   | `error`                     |
| Error image used in a view for timeouts, when no agents are available, or for an unknown error | `genericError`              |
| Minimize button (Knowledge and Chat)                                                           | `minimizeButton`            |
| No connection                                                                                  | `noConnection`              |
| Send button (Case Publisher and Chat)                                                          | `send`                      |
| Next field button (Case Publisher and Chat)                                                    | `submitButtonNextArrow`     |
| Previous field button (Case Publisher and Chat)                                                | `submitButtonPreviousArrow` |
| Attachment button when the user can attach a file                                              | `attachmentClipIcon`        |
| Avatar used for the agent (only the inscribed circle is visible in the chat feed)              | `chatAgentAvatar`           |
| Avatar used for Einstein bot (only the inscribed circle is visible in the chat feed)           | `chatBotAvatar`             |
| Icon used for Einstein bot persistent footer menu                                              | `chatBotFooterMenu`         |
| Icon used in the pre-chat screen                                                               | `preChatIcon`               |

In Swift:

```java
// Create appearance configuration instance
let config = SCAppearanceConfiguration()

// Specify images
config.setImage(MY_CUSTOM_IMAGE,
                compatibleWithTraitCollection: MY_TRAITS,
                forName: ENUM_VALUE)

// Add other customizations here...

// Save configuration instance
ServiceCloud.shared().appearanceConfiguration = config
```

In Objective-C:

```java
// Create appearance configuration instance
SCAppearanceConfiguration *config = [SCAppearanceConfiguration new];

// Specify images
[config setImage:MY_CUSTOM_IMAGE compatibleWithTraitCollection: MY_TRAITS
         forName: ENUM_VALUE];

// Add other customizations here...

// Save configuration instance
[SCServiceCloud sharedInstance].appearanceConfiguration = config;
```