Docs
Chatbot Experience
Chatbot presentation launches the quiz from a floating bubble instead of an inline card. The bubble appears on the public /q page and any embed that uses data-quizflow-mode="chat", keeping the conversation tone on-brand while respecting the host page's layout.
This guide will walk you through:
- Enabling Chatbot mode from Interface settings and seeing the bubble in preview.
- Customizing the launcher text, color, and edge alignment so the bubble matches your brand voice.
- How the embed snippet and public view share the same chat data attributes.
- Saving your settings, publishing, and re-sharing so the bubble roll-out stays in sync.
When to use this
Choose Chatbot when you want a lightweight, conversational launch trigger instead of a full widget so the experience feels like a branded assistant hovering on the page. It works great for lead forms, guides, and short quizzes that should pop open on demand.
How it works
- Presentation: In Interface settings > Presentation, select Chatbot. The builder instantly previews the bubble on the right edge by default, and the same bubble loads on
/q/{slug}plus any embed snippet that opts into chat mode. - Branding & alignment: Customize the launcher label, choose
LeftorRightpositioning, and pick a primary color so the bubble mirrors your palette. Interface settings surfaces live previews so you can confirm the placement and label. - Embed snippet: The embed automatically injects
data-quizflow-mode="chat"plusdata-quizflow-chat-position,data-quizflow-chat-text, anddata-quizflow-primary-colorwhen chat presentation is active. You can also add those data attributes manually if you want to force the bubble without switching the saved presentation style. - Publish cycle: The chat bubble relies on the published quiz definition, so re-publish after editing the launcher text, color, or position so embeds load the newest values.
Step-by-step
- Open Interface settings > Presentation and choose Chatbot as the public view style.
- Use the Branding & alignment section to edit the launcher text, color, and chat position.
- Copy the embed snippet from Installation; it already picks up the chat attributes, or add
data-quizflow-mode="chat"yourself. - Publish or re-publish the quiz so the public page and embeds render the bubble you just designed.
Tips / Gotchas
- The same bubble appears on the hosted
/q/{slug}page and embeds, so respondents see a consistent chat tone even when you drop the quiz on another site. - Leaving the chat launcher text blank falls back to the default Chat label.
- Changing the chat text, color, or alignment requires a new publish so the snippet picks up the latest data attributes.
- Embedded Chatbot mode still respects
Show QuizFlow Labs brandingand the nav alignment you saved under Interface settings. - Use Embed Widget or Interface Settings docs when you need to troubleshoot script loading or presentation overrides.

