Who This Is For / When to Use
Accounts embedding the Kyrios chat widget on websites
Teams managing live chat, SMS, or email conversations
Businesses that need brand-consistent chat experiences
Where Chat Widget Settings Are Located
Chat widget customization is managed from the Chat Widget editor.
Settings are divided into:
Style
Chat Window
Messaging
All changes can be previewed before publishing
Create or Open a Chat Widget
Step 1: Open Chat Widget Editor
Navigate to Sites
Open Chat Widget
Create a new widget or select an existing one
Customize Chat Icon and Theme
Change the Chat Icon
Select a predefined icon (chat bubble, message, WhatsApp-style)
Icons control how the widget appears when minimized
Select a Theme
Choose from preset color themes
Themes update:
Header color
Buttons
Message bubbles
Customize the Chat Window Content
Edit Title and Intro Text
Go to Chat Window
Update:
Chat window title
Intro message shown to visitors
Button text
Configure Contact Form Fields
Choose which fields appear before chat starts
Supported fields include:
Name
Phone
Email
Message field is optional for SMS/email chats
Enable Agency Branding (“Powered by”)
What Agency Branding Does
Displays custom branding text at the bottom of the widget
Replaces default “Powered by” text
How to Configure It
Go to Additional Options
Enable Agency Branding
Set:
Branding title
Display name
URL
Result:
The widget footer displays your custom branding.
Enable Notification Sound
Turn on Notification Sound to play a sound when messages arrive
Applies only to live chat conversations
Avatar Image and Optimization
Avatar Image Settings
Enable Allow Avatar Image
Upload or replace the avatar image
Image Optimization
When enabled:
Avatars are optimized for speed
Images are served via CDN with caching
Can be disabled to use high-resolution images
Set Widget Position and Size
Widget Position
Choose where the widget appears on desktop:
Bottom left
Bottom right
Top positions
Widget Dimensions
Use Auto for responsive sizing
Use Custom to set:
Widget width
Widget height
Choose Chat Channels
Available Chat Types
You can enable one or more channels:
SMS / Email Chat
Live Chat
Facebook Chat
Instagram Chat
WhatsApp Chat
Voice AI
Customize Greetings and Messages
Returning Visitor Greeting
Enable Custom Greeting
Use variables like
{{name}}to greet returning visitors
Acknowledgement and System Messages
Customize system messages such as:
“Chat closed due to inactivity”
Assignment messages
Help prompts
How Messages Appear in Conversations
Contact details submitted via widget appear in the conversation
Empty message fields show only contact details
Links and formatted text display correctly
Common Issues and Fixes
Branding Not Showing
Cause: Agency Branding is disabled.
Fix: Enable Agency Branding and save changes.
Avatar Looks Blurry
Cause: Image optimization is enabled.
Fix: Disable optimization and upload a high-resolution image.
Widget Not in Correct Position
Cause: Incorrect widget position selected.
Fix: Update Widget Position and republish.
FAQ
Can I preview chat widget changes?
Yes. All changes can be previewed before publishing.
Can I remove the “Powered by” text?
You can replace it with custom branding using Agency Branding.
Can I customize messages for returning visitors?
Yes. Enable Custom Greeting and use the {{name}} variable.
Can I control widget size?
Yes. You can use Auto sizing or set custom width and height.
Does the widget support multiple channels?
Yes. You can enable SMS, email, live chat, social channels, and Voice AI.