MonCha
Skip to article

Customize the widget

Search MonCha documentation

Search the full guides for topics such as renewal, ticket alerts, OAuth or knowledge refresh.

Everything on the Widget page updates instantly on your live site — you never re-paste the snippet.

On this page

Content

  • Bot name and tooltip shown on the launcher.
  • Welcome message — the first thing customers read.
  • Input placeholder.
  • Disclaimer text — a small line under the chat, for compliance notes.

Appearance

  • Primary color — header, buttons, and accents. Plus separate overrides for link color, the launcher's background (or make it transparent, for a PNG launcher icon with its own background), and the voice orb color during a live call.
  • Custom icons — upload your own launcher icon, bot avatar, user avatar, and agent avatar (shown on ticket replies) instead of the defaults.
  • Font size and chat height.
  • Icon size and shape — circle, rounded, or square.
  • Position and offsets — bottom-right or bottom-left, with separate offsets for desktop and mobile.
  • RTL — right-to-left layout for Urdu and Arabic scripts.
  • Expand button — adds a fullscreen toggle to the header.
  • External link — an outbound link-out icon in the header, pointed at any URL you choose.

Behavior

  • Auto-open after N seconds on desktop or mobile.
  • Require terms before chatting, with a link to your terms page.
  • Max messages per conversation — cap how many replies one conversation can use (0/blank = unlimited); useful for controlling cost exposure per visitor.
  • Download transcript — lets visitors save the chat as a text file.
  • Temporarily disable chat — takes the bot offline everywhere it's embedded and shows a message you write, without touching the snippet or your knowledge base.

Home screen

Shortcuts on the widget home (WhatsApp, Facebook Messenger, X, LINE, Booking) — at most two at a time. WhatsApp uses the number connected for this bot in Integrations; turn it on or off here or with Show on website widget. Facebook, X, and LINE need a public URL and logo. Booking needs Enable booking first.

Quick prompts and follow-up chips

Quick prompts are the suggested questions on the welcome screen — the single best lever for getting customers to engage. Don't guess them: click Suggest from knowledge base and MonCha proposes questions grounded in what you've actually indexed.

Follow-up chips appear after each reply. Leave them on auto and the bot suggests relevant next questions, or supply a fixed list.

Visibility

  • Hide source attribution — the “answered from” links under replies.
  • Hide feedback buttons — the thumbs up/down.
  • Hide refresh.
  • Hide launcher tooltip — the hint bubble above the chat icon.
  • Hide “Powered by MonCha” — available as a separate add-on for standard plans and included on enterprise bots. The add-on also unlocks a custom watermark: turn the branding text into a link to your own site, with your own logo.

Localization

All 24 supported languages are translated out of the box — the bot-settings language picks the translation automatically, including the lead form and the “talk to a human” button. Use the Localization tab only to override a specific string with your own wording.

Per-bot design

Each bot has its own widget config. Switch bots in the sidebar and style them independently. Extra bots work the same way — each has its own design and embed. See Plans & quotas.

Booking

Turn on Enable booking under Icon & position (or on the Bookings page) to add a calendar button to the widget. Visitors request a time; you still approve each request. See Bookings for clinic, gym, salon, and hourly-hire setups.

Related guides

Something unclear? Tell us.

Start free trial