Customize the chat surface
The Chat App Customizer is where you brand the full-page chat surface
rendered by the [mga_chat_app] shortcode. Every change you make
belongs to the bot selected in the Bot workspace dropdown — there is
no “global” config and you can never accidentally save settings against
the wrong bot.
Open the customizer
Section titled “Open the customizer”-
In the WP admin, open MGA WP.
-
In the Bot workspace dropdown, pick the bot you want to brand.
-
Click Chat app sections → Branding in the sidebar (or any other section).
-
The right column is the live form; the right of the form is a live preview that reflects every change before you save.
-
Click Save changes in the sticky top toolbar to persist. Reset reverts the entire form to defaults; Discard drops unsaved edits and reloads the saved state.
What the customizer looks like
Section titled “What the customizer looks like”The customizer is per-bot
Section titled “The customizer is per-bot”Below is the same customizer pane after you switch the dropdown to a different bot. Notice the title in the toolbar updates — and the saved field values are independent.
What you can customize
Section titled “What you can customize”| Section | What it controls |
|---|---|
| Branding | Theme (auto/light/dark), density, max content width, border radius, primary/accent/background/surface/text colors, font family, brand logo, bot avatar. |
| Welcome | Header title & subtitle, welcome heading & subheading, suggested prompts (one per line, max 6), hide-after-first-message, randomize prompts. |
| Messages | Bubble shape (rounded / pill / square), per-side bubble & text colors, show avatars, show timestamps, per-message actions (sources / regenerate / copy / feedback). |
| Composer | Placeholder text, max message length, Enter vs Cmd/Ctrl+Enter to send. |
| Sidebar | Enable conversations panel, sidebar title, “New chat” label. |
| Footer & Legal | Powered-by line, footer HTML, privacy & terms URLs. |
| Behavior | Auto-scroll, Require WordPress login, sign-in copy & redirect, guest mode, empty/network/rate-limit error copy. |
| Advanced | Custom CSS injected as a scoped <style> inside the chat surface. |
| Embed | Per-bot shortcode you paste into a page or post — see the next tutorial. |
Continue to Copy the embed shortcode →.