Docs/Customization/Customizing Your Widget

Customizing Your Widget

Match the Kwiro chat widget to your store's brand with custom colors, position, welcome message, and bot name.

Make the Widget Feel Like Part of Your Store#

Kwiro's chat widget is fully customizable so it blends seamlessly with your store's design. Every change you make takes effect immediately -- no need to republish or redeploy anything.

The Widget & AI page with branding controls and a live preview pane on the right.
Screenshot: The Customize panel in your dashboard. Settings on the left, live preview on the right — what you see is what your shoppers will see.

Where to Find Widget Settings#

  1. Go to your WordPress admin dashboard
  2. Click AI Sales Assistant in the left sidebar
  3. Select the Widget tab at the top of the settings page

Change Your Brand Color#

The Primary Color setting controls the color of the chat header, send button, and chat bubble.

Click the color picker or type in your brand's hex color code (for example, #2563EB for blue). The preview on the right side of the page updates in real time so you can see how it looks before saving.

Pick a color that matches your store's header or logo for a seamless look.

Set the Widget Position#

Under Widget Position, choose where the chat bubble appears:

  • Bottom Right (default) -- works best for most stores
  • Bottom Left -- use this if you have other elements in the bottom-right corner, like a cookie banner or back-to-top button

Write a Custom Welcome Message#

The Welcome Message is the first thing customers see when they open the chat. The default is "Hi! I'm here to help you find the perfect product. Ask me anything!"

You can change this to match your brand voice. Some examples:

  • "Welcome to [Store Name]! Looking for something specific? I can help."
  • "Hey there! Need help picking the right product? Just ask."
  • "Hi! I know our entire catalog. Tell me what you need."

Keep it short, friendly, and focused on helping the customer.

Name Your Bot#

The Bot Name appears at the top of the chat window next to the header. The default is "AI Assistant," but you can change it to anything:

  • Your store name (e.g., "StyleBot" for a fashion store)
  • A friendly name (e.g., "Luna" or "Max")
  • A descriptive name (e.g., "Shopping Helper")

Save Your Changes#

After making your changes, click the Save Settings button at the bottom of the page. Your widget will update on your live store within seconds. Visit your store in a new tab to verify everything looks right.

Widget proactive greeting on the FitGear demo store, with a 'Looking for something?' bubble and quick-reply chips.
Screenshot: The proactive greeting bubble — what shoppers see before they click. Customizable copy, customizable quick replies.
Was this page helpful?
Updated April 2026

Related reading