Customize Chat Images with the Service Chat SDK
Specify custom images used throughout the chat UI.
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.
The Service Chat SDK allows you to customize chat images in the UI. If you want to change an image, override the Drawable for the image you want to customize using the exact same file name. The following table contains a list of the most common overridable images.
| Image File Name | Description |
|---|---|
| chat_ic_footer_menu.xml | Hamburger menu on the bottom of the window, next to the chat input. (48dp x 48dp) |
| chat_ic_minimized_connecting.xml | Connecting icon when the view is minimized. (32dp x 29dp) |
| chat_minimized_message_indicator.xml | Chat bubble unread indicator when the view is minimized. (27dp x 24dp) |
| common_ic_close.xml | Close button at the top left of the window. (24dp x 24dp) |
| salesforce_agent_avatar.xml | Agent avatar used beside the agent’s chat bubble. (36dp x 36dp) |
| salesforce_ic_message_send.xml | Send message button next to chat input. (24dp x 24dp) |
| salesforce_ic_minimize.xml | Minimize button at the top right of the window. (18dp x 18dp) |
To customize the chat bot avatar and the bot banner, see Use Einstein Bots with Chat.
For instance, if you’d like to override the agent avatar during a chat session, add a Drawable to your res/drawables folder with the name salesforce_agent_avator.xml. This value should contain image info about the agent avatar.
The following list contains all the customizable Drawables used throughout the chat UI: chat_button.xml, chat_button_pressed.xml, chat_footer_menu_item.xml, chat_ic_bubble.xml, chat_ic_close.xml, chat_ic_collapse.xml, chat_ic_footer_menu.xml, chat_ic_last_photo.xml, chat_ic_minimized_connecting.xml, chat_ic_photo_gallery.xml, chat_menu_bottom_button.xml, chat_menu_button.xml, chat_menu_header.xml, chat_menu_solo_button.xml, chat_menu_speech_arrow.xml, chat_menu_top_button.xml, chat_minimized_message_indicator.xml, agent_initial_avatar.xml, link_preview_arrow.xml, progress_indeterminate_horizontal_material.xml, salesforce_agent_avatar.xml, salesforce_button.xml, salesforce_button_solid.xml, salesforce_horizontal_rule.xml, salesforce_ic_camera.xml, salesforce_ic_message_send.xml, salesforce_ic_minimize.xml, salesforce_loading_ball.xml, salesforce_message_bubble_overlay.xml, salesforce_message_bubble_received.xml, salesforce_message_bubble_received_speech_arrow.xml, salesforce_message_bubble_sent.xml, salesforce_minimized_view.xml, salesforce_minimized_view_toolbar.xml, vector_drawable_progress_indeterminate_horizontal.xml.