Appearance settings
Navigation: WordPress Admin → WooCommerce → AI Assistant → Settings → Appearance
Independent of the active theme, Elementor, and Divi. Colors are 6-digit hex only.
Chatbot Name
What it does Text in the chat header.
Default value Translated string AI Assistant (Settings::default_widget_title()). Empty setting uses that default.
Available options Text, max 80 characters.
Recommended configuration Your brand assistant name.
When to use it Always.
Effect on the frontend Header title.
Dependencies None.
Important notes i18n applies to the default, not to a custom saved name.
Example Shop Helper
Welcome Message
What it does First assistant message when a shopper opens the chat. Emoji picker available in admin.
Default value Translated Hello! How can I help you today? Empty uses that default.
Available options Textarea, max 400 characters.
Recommended configuration If you use multilingual fallbacks, consider leaving this empty so AI Language → Fallback Messages → Welcome can vary by language. A saved custom greeting overrides language-aware welcome.
When to use it Single-language stores.
Effect on the frontend First bubble.
Dependencies None.
Important notes This is the common override pitfall for multilingual welcome.
Example Leave empty on a multilingual store.
Chatbot Avatar
What it does Header image from the Media Library.
Default value None (0).
Available options Attachment ID. 100×100px recommended.
Recommended configuration A square logo.
When to use it Brand recognition.
Effect on the frontend Avatar URL in appearance payload.
Dependencies WordPress media.
Important notes Uses thumbnail size.
Example Upload a 200×200 PNG.
Show floating assistant
What it does Adds a launcher on storefront pages. Hidden automatically on pages that already include [ai_woocommerce_assistant].
Default value On.
Available options On / Off.
Recommended configuration On, unless you embed the shortcode site-wide.
When to use it Off + shortcode on Contact only, for a quieter shop.
Effect on the frontend Floating button vs inline only.
Dependencies Enable AI Agent.
Important notes Does not print in wp-admin.
Example On for most stores.
Launcher position
What it does Corner for the floating button.
Default value bottom-right
Available options Bottom right, Bottom left.
Recommended configuration Bottom right, unless it covers a live-chat or cookie banner.
When to use it Bottom left if another widget owns the right corner.
Effect on the frontend Launcher CSS position.
Dependencies Show floating assistant.
Important notes No top positions in this version.
Example Bottom left when Tidio occupies bottom right.
Accent color
What it does Used for links, focus rings, and comparison highlights. Also the fallback for user bubble, send button, and launcher if those colors are empty.
Default value #0073ee
Available options #rrggbb
Recommended configuration Brand primary.
When to use it Always set once.
Effect on the frontend Theme-independent accent.
Dependencies None.
Important notes Invalid hex falls back to #0073ee.
Example #1a1a1a for a black-label shop.
Widget colors
Independent backgrounds/text for:
| Group | Background setting | Text setting | Default look |
|---|---|---|---|
| User message | widget_color_user | widget_color_user_text | Accent / #ffffff |
| Assistant message | widget_color_assistant | widget_color_assistant_text | #ffffff / #111111 |
| Send button | widget_color_send | widget_color_send_text | Accent / #ffffff |
| Launcher | widget_color_launcher | widget_color_launcher_icon | Accent / #ffffff |
Reset colors writes the factory hex values and saves them (does not leave fields empty).
Recommended configuration Start from Reset, then change accent.
Effect on the frontend Bubble and launcher colors only.
Example Dark launcher with white icon; white assistant bubbles for readability.