Use Chat Widget customization settings to control how your widget looks, where it appears, what visitors see, and how it behaves on your website.
Available customization options can vary depending on the Chat Widget type you select.
TABLE OF CONTENTS
- Key Benefits of Customizing Your Chat Widget
- Create or Open a Chat Widget
- Widget
- Chat Window
- Messaging
- Related Articles
Key Benefits of Customizing Your Chat Widget
- Match your brand: Customize the widget theme, colors, icons, avatar images, and visitor-facing messages.
- Control widget placement: Choose between sticky and embedded placement options based on your website layout.
- Adjust the visitor experience: Configure messages for first-time and returning visitors, Chat Window content, and acknowledgement messages.
- Optimize loading behavior: Delay widget loading until a visitor interacts with the page or allow it to load immediately.
- Configure notice and consent: Display a legal notice, collect consent, and control whether the consent checkbox is required or pre-selected.
Create or Open a Chat Widget
- Go to Sites > Chat Widget.
- Click New to create a Chat Widget, or open an existing widget you want to customize.
- Open the widget configuration to customize its settings.
For complete instructions on Chat Widget types, creation, setup, and installation, see Getting Started with Chat Widget .
Widget
Use the Widget section to control the appearance, placement, and dimensions of your Chat Widget.
Chat Launcher
Configure the Chat Launcher that visitors use to open the widget.
You can display the launcher with or without a prompt message to encourage visitors to start a conversation.
Chat Icon Selection
Choose the chat icon that best matches your website and brand experience.
Theme Customization
Select a predefined theme or customize the widget colors and styling to match your brand.
First-Time and Returning Visitor Messages
Configure different messages for first-time and returning visitors to personalize the Chat Widget experience.
Avatar Images
Add avatar images for agents or support teams to give visitors a more recognizable and personalized interaction.
Widget Placement
Choose how and where the Chat Widget appears on your website.
- Sticky: Keeps the widget fixed in a page corner, such as the bottom-left or bottom-right corner.
- Embedded / Inline: Displays the complete conversation experience within your page content.
Embedded / Inline placement is available for All-in-One Chat, Email/SMS, WhatsApp, Facebook, Instagram, Live Chat, and Voice AI.
Widget Dimensions
Keep the widget dimensions set to Auto, or select Custom to configure the width and height for your website layout.
Custom dimensions support values starting from 200px and are not restricted by the previous placement-based minimum dimensions.
Use Set to Default to restore the recommended dimensions for the current widget placement.
When you switch between Sticky and Embedded Live Chat, custom dimensions reset to the recommended defaults for the newly selected placement.
If custom dimension values are missing or set to Auto, the widget uses the default dimensions.
Configured dimensions are respected without being automatically increased to previous minimum values. Improved overflow handling also helps keep the widget within its container.
Chat Window
Use the Chat Window section to configure the static content visitors see when they open the widget.
Available fields can vary depending on the Chat Widget type.
Chat Window Content
Configure visitor-facing content such as the Chat Window title, introductory message, email option, and call-to-action button.
Load on User Interaction
Use Load on user interaction to control when the Chat Widget loads on your website.
| Enabled | Disabled |
|---|---|
| The widget loads after visitor interaction, such as a scroll, click, or touch. If no interaction occurs, it automatically loads after approximately 8 seconds. | The widget loads immediately. |
Compliance Notice & Consent
Use Compliance notice & consent to configure the legal notice and consent experience shown with your Chat Widget contact form.
Go to Chat Widget > Chat window > Additional options > Compliance notice & consent.
You can configure the following options:
- Show legal notice: Display a read-only disclosure below the contact form. Visitors do not need to take action on the notice.
- Add a consent checkbox: Display a checkbox with custom consent text for visitors to acknowledge or opt in.
- Make this checkbox required: Require visitors to select the consent checkbox before submitting the form. Leave this setting off to make consent optional.
- Pre-check the box by default: Display the consent checkbox as already selected when the form loads.
If consent is required and the visitor does not select the checkbox, the widget displays Please tick this box to continue.
The live preview updates as you configure these settings. Click Save when you finish.
View Consent Details for a Submission
Chat Widget form submissions record consent information in the contact's Activity details.
The Activity details show:
- Whether the visitor gave consent.
- Whether consent was required.
- The consent text shown to the visitor.
Existing Widgets and Default Compliance Settings
- Existing widgets keep their current appearance and behavior until you open and save them in the builder.
- Existing legal text is carried over automatically to the corresponding compliance field.
- Widgets created through A2P registration keep their existing compliance configuration.
- New widgets start with the legal notice enabled and the consent checkbox enabled. Required consent is disabled by default.
- You do not need to change your existing website embed code.
Note: A2P-generated Chat Widgets can contain locked disclosure language, required fields, and consent settings. See the A2P article in the Related Articles section for details.
Messaging
Use the Messaging section to configure acknowledgement messages, greetings, support information, and language settings.
Support Details, Greetings, and Acknowledgement Messages
Configure the support contact details, greeting, and acknowledgement message shown to visitors.
Language Settings
Select the language used by the Chat Widget.
Related Articles
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article