Docs/widget setup

Widget setup

Customize the chatbot widget, configure allowed domains, and copy your embed code.

Design

Use the Widget page to customize how your chatbot looks on your website.

→Colors — primary and background color
→Launcher label — button text
→Welcome title and message
→Chatbot name and avatar
→Position — bottom left or bottom right
→Branding — hide AskGPT badge (Enterprise plan)

Domain access

Add the exact domains where your chatbot widget is allowed to run. If the domain list is empty, the widget is public and will respond on any website.

→Add each domain where the widget should run
→Leave empty to keep the chatbot public on any origin
→Add localhost for local development testing

💡Use the exact hostname without protocol — e.g. yoursite.com not https://yoursite.com. Add www and non-www separately if needed.

Embed script

Copy the embed script and paste it before the </body> tag on every page where you want the chatbot to appear. You can also customize widget spacing using data attributes on the script tag.

→data-bot-id (required) — your unique chatbot identifier
→data-margin-bottom (optional) — vertical offset from screen bottom in px (default 22)
→data-margin-side (optional) — horizontal offset from screen edge in px (default 22)

Verify the install

After adding the script, open the published page (not the dashboard) and confirm the chat launcher appears. Send a test message to verify the full flow works.

→Open the live page URL
→Confirm the chat launcher appears
→Send a test question
→Verify the response is accurate
→Test on a mobile device

Test and publish Platform embeds

Need more help?

Contact support and we'll get back to you within 24 hours.