Embedded Service Chat for Web Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
Embedded Service Chat for Web Developer Guide
Adjust General Parameters
Set the Width, Height, and Base Font Size
Set a Domain
Set the Language
Set Right-to-Left Language Layout
Change the Embedded Chat Window Appearance and Behavior
Customize Embedded Chat
Customize the Channel Menu
Embedded Service Customized Components
Code Snippet Versions
PDF

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