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.

Important

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.

Note

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.