Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Set the Width, Height, and Base Font Size

Change the default sizes for your chat window in the code snippet to match your websites requirements.

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

Keep the following in mind when setting your sizes:

You can enter values in pixels (px), percent (%), or em or rem.
When you set the width in your code snippet, the max-width is set to none. Similarly, when you set the height, the max-height is set to none. This action prevents the chat window from auto-sizing if the browser window’s height or width changes to less than the set height or width of the chat window.
If the height of the browser window is less than 498px, the height defaults to 90% of the browser window’s height.

Set the width

embedded_svc.settings.widgetWidth = "..."

To customize the width of the chat window, add this parameter to your code snippet and set the width in pixels (px) or percent (%). If you don’t specify a value, the default size of 320px is used.

Set the height

embedded_svc.settings.widgetHeight = "..."

To customize the height of the chat window, add this parameter to your code snippet and set the height in pixels (px) or percent (%). If you don’t specify a value, the default size of 498px is used.

Set the font size

embedded_svc.settings.widgetFontSize = "..."

To customize the base font size for the text in the chat window, add this parameter to your code snippet and set the base font size. If you don’t specify a value, the default size of 16px is used.

We recommend selecting a size no smaller than 12px and no larger than 24px.

Tip

Embedded Service Chat for Web Developer Guide

Set the Width, Height, and Base Font Size

Set the width

Set the height

Set the font size