Specify Chat Images

Use your own images for the pre-chat banner, header logo, waiting state image, and the agent and Einstein Bots avatars. We recommend adding your images in Embedded Service setup, but you can use these settings to override what you created in setup.

The legacy chat product is in maintenance-only mode, and we won't continue to build new features. You can continue to use it, but we no longer recommend that you implement new chat channels. Instead, you can modernize your customer communication with Messaging for In-App and Web. Messaging offers many of the chat features that you love plus asynchronous conversations that can be picked back up at any time.

Important

If the images are hosted in the same repository as the web page where you add the chat window, you can use either the relative URL paths and names or full URLs. If the images are hosted elsewhere, use the full URLs.

Before customizing the code, upload the image files that you want to use in the chat window. Create your images in .png format and use the recommended sizes to ensure that the images don’t become distorted during the chat experience.

Pre-Chat Banner

embedded_svc.settings.prechatBackgroundImgURL = "..."

Specify a URL to set an image in the pre-chat form below the header and above the fields.

We recommend an image that’s 320x100 pixels.

Tip

Logo for Header and Minimized Chat

embedded_svc.settings.smallCompanyLogoImgURL = "..."

Specify a URL to set the logo for the chat header and minimized chat.

We recommend a logo that’s 36x36 pixels.

Tip

Waiting State

embedded_svc.settings.waitingStateBackgroundImgURL = "..."

Specify a URL to set the background image when the chat is in a waiting state.

We recommend an image that’s 250x60 pixels.

Tip

Agent Avatar

embedded_svc.settings.avatarImgURL = "..."

Specify a URL to set the image of the agent that appears during pre-chat and chat. If your chat window uses an automated invitation, this image appears in the top left of the invitation with the default HTML and CSS in the snippet.

We recommend an image size that’s 40x40 pixels.

Tip

Einstein Bots Avatar

embedded_svc.settings.chatbotAvatarImgURL = “...”

Specify a URL to set the avatar image that appears when the customer is chatting with a bot.

We recommend an image size that’s 40x40 pixels.

Tip