Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.harmonica.chat/llms.txt

Use this file to discover all available pages before exploring further.

​
What are widgets?

Widgets are structured interaction elements the AI facilitator can embed in the participant chat alongside its usual open-ended questions. Instead of (or in addition to) a free-text reply, a participant might see:
  • A single-choice poll — pick one option from a list
  • A multi-choice poll — select all that apply
  • A rating scale — choose a value between two labelled endpoints
  • A ranking list — drag items into priority order
The facilitator decides when to offer a widget and which type fits the moment. Widgets appear when the conversation reaches a narrowing or prioritisation point — the model uses the session’s goal and the flow of the conversation to judge whether a structured input is more useful than prose.
Widgets are an opt-in feature. They are off by default and only appear in conversations where you have explicitly enabled them.

​
Enable widgets for a session

You control widgets per session from the session’s Session Design settings.
1

Open Session Design

From your session’s results page, open Session Design — either from the settings icon or via the session overview panel.
2

Find the Polls and ratings toggle

In the Facilitation Approach section, locate Polls and ratings. Toggle it on.
3

Save

Save the change. The setting applies to all new conversations immediately. Conversations already in progress are not affected.
Widgets work best in sessions with a clear narrowing goal — such as prioritisation exercises, preference surveys, or agreement checks. For exploratory or discovery sessions, free text tends to surface richer qualitative insight.

​
What participants see

When the facilitator decides to use a widget, it appears as an interactive element in the chat — below the facilitator’s message and above the text input. Participants submit it with a single click or tap. Once submitted, the widget locks and shows their selected answer. Participants can still type freely in the same conversation. Widgets supplement the conversation, they don’t replace it.

​
Widget responses in results

Participant widget submissions are captured alongside their text responses. When you review results, widget tallies appear as part of the conversation record — you can see how participants answered each structured question across the session.

Session settings

Other per-session configuration options

Session results

Reviewing participant responses