🎭

Widget appearance variants

Variants let one agent have different visitor-facing copy on different pages or portals while keeping the same knowledge, instructions, model, and conversations.

Create a variant

  1. Open Appearance and find Widget variants.
  1. Select Add variant and give it a clear name.
  1. Set a unique key using lowercase letters, numbers, and dashes.
  1. Optionally override the welcome message, input placeholder, and up to five conversation starters.
  1. Save variants, then copy the installation value shown in the editor.

Select a variant in an installation

Installation
How to select the variant
Popup script
Add data-variant="your-key" to the loader script
Inline iframe
Add ?variant=your-key to the embed URL
Shareable link or portal
Add ?variant=your-key to the agent URL
If the flag is missing or the key does not match a saved variant, Chatwith uses the base appearance.

Good uses for variants

  • Give product and pricing pages different conversation starters.
  • Match the welcome message to a customer portal or campaign.
  • Localize short interface copy while keeping one agent.
  • Run different entry experiences without duplicating knowledge.

Related guides