Copy the embed shortcode
The full-page chat surface is embedded via the [mga_chat_app]
shortcode. Each bot has its own shortcode — there is no
“one shortcode for everything.” The Embed tab generates the snippet
pre-filled with the bot you’ve selected in the Bot workspace dropdown.
Where the shortcode lives
Section titled “Where the shortcode lives”-
Open the customizer for the bot you want to embed. (
MGA WP →pick a bot in the dropdown.) -
Click “Embed” in the sidebar’s Chat app sections.
-
Copy the value from the read-only field. The shortcode contains the bot’s portable
public_id, so it works across reinstalls and even across WordPress sites that share the same MyGPT Assistants account. -
Paste it into the Gutenberg block of your choice (a Shortcode block, a Custom HTML block, or a classic editor). Save the page. Visit it — the full-page chat surface renders inline.
What the Embed tab looks like
Section titled “What the Embed tab looks like”Copy shortcode
Customization is stored per bot. This shortcode only needs the bot identifier.
Switching bots = switching shortcodes
Section titled “Switching bots = switching shortcodes”Pick a different bot in the dropdown and the Embed tab regenerates the
snippet with that bot’s public_id. There is no global “the plugin’s
shortcode” — every bot owns its own.
Copy shortcode
Customization is stored per bot. This shortcode only needs the bot identifier.
Per-embed overrides (advanced)
Section titled “Per-embed overrides (advanced)”The [mga_chat_app] shortcode also accepts per-embed attribute
overrides — useful when you want the same bot to render differently
on different pages (e.g. a darker theme on a marketing page, a
narrower max-width inside a sidebar).
| Attribute | Type | Example |
|---|---|---|
public_id | string | public_id="a8d3-…-f72c" — required (or bot_id="N"). |
height | px / vh / % | height="100vh" |
theme | light / dark / auto | theme="dark" |
primary_color | hex | primary_color="#3b82f6" |
max_width | CSS length | max_width="640px" |
sidebar | true / false | sidebar="false" |
require_wp_login | true / false | require_wp_login="true" |
submit_on_enter | true / false | submit_on_enter="false" |
Example:
[mga_chat_app public_id="a8d3-…-f72c" theme="dark" max_width="640px" sidebar="false"]Attributes only override the customizer config for that specific embed. The saved customizer config stays untouched.
Next: Require WordPress login →.