# Quiz Options

Quiz Options are interactive multiple-choice buttons that Alhena's AI presents during a conversation. When the AI determines that a question could be narrowed down with a selection, it displays clickable options instead of asking the customer to type a follow-up.

This is especially useful for product recommendations, where the AI can guide customers through a series of choices to find the right product.

<figure><img src="/files/uSTUBY8jng7Afe2dKws4" alt=""><figcaption><p>[Chat Widget with quiz options visible]</p></figcaption></figure>

## How It Works

1. A customer asks something like "I'm looking for a new moisturizer"
2. The AI responds with a question and presents options — e.g. "What's your skin type?" with buttons for **Oily**, **Dry**, **Combination**, **Sensitive**
3. The customer taps an option, which is sent as their reply
4. The AI may ask another narrowing question or recommend products based on the selections

Quiz options appear automatically when the AI determines they would be helpful. There is no manual configuration required — the AI generates options based on your knowledge base and product catalog.

## Appearance

Option buttons are styled to match your widget's color scheme. They use your configured message text color and background color, and respect your widget's font size settings.

## SDK Events

You can listen for the `ticket:quiz_options_rendered` event to track when options are shown:

```javascript
window.gleenWidget.on("ticket:quiz_options_rendered", function (data) {
  console.log("Options shown:", data.options);
  console.log("Message ID:", data.messageId);
});
```

See [Events](/docs/developer-reference/website-sdk/events.md) for the full list of widget events.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alhena.gitbook.io/docs/features/chat-widget/quiz-options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
