> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/features/chat-widget/suggested-questions.md). # Suggested Questions Suggested questions are AI-generated follow-up prompts that appear during a conversation, helping customers explore related topics and find answers faster. *** ### 1. What are suggested questions? Suggested questions are contextual follow-up prompts that appear after the AI responds to a customer. They help guide the conversation by surfacing related topics the customer may not have thought to ask, keeping them engaged with clear next steps.

Suggested questions appear as tappable buttons below the AI's response

*** ### 2. How suggested questions work 1. A customer sends a message in the chat widget. 2. The AI generates a response. 3. The **Suggested Questions Agent** analyzes the conversation context and generates relevant follow-up questions. 4. The questions are delivered in real time and appear as tappable buttons below the AI's response. 5. When a customer taps a suggested question, it is sent as their next message and the conversation continues. {% hint style="info" %} Suggested questions share the same space as [icebreakers](/docs/features/chat-widget/icebreakers.md). When icebreakers are available, they take priority. {% endhint %} *** ### 3. Enable the Suggested Questions Agent The suggested questions feature is powered by a dedicated built-in agent. To enable it: 1. Log in to the **Alhena Dashboard**. 2. Navigate to **AI Settings > Agents**. 3. Find the **Suggested Questions** agent card. 4. Toggle the agent to **Enabled**. The agent does not require any tools or additional integrations to be configured. Once enabled, it will automatically start generating suggested questions for conversations on your website chat widget. {% hint style="info" %} The Suggested Questions Agent does not support custom tools. Its behavior can be customized using [Guidelines](/docs/ai-configuration/tuning/guidelines.md). {% endhint %} *** ### 4. Customize the appearance You can style the suggested questions to match your website's brand. These settings are part of the [widget customization](/docs/features/chat-widget/customization.md) options. To access them: 1. Navigate to **Integrations > Website > Configure Settings**. 2. Scroll down and expand the **Suggested questions** accordion. The following options are available: | Setting | Description | Default | | --------------------------------- | ------------------------------------------------------------------------------- | -------------------- | | **AI icon** | Custom icon displayed alongside each question | Default sparkle icon | | **Text color** | Text color for the question labels | `#293037` | | **Font weight** | Weight of the question text, from `100` to `900` | Default | | **Background** | Background of the question buttons (can be a gradient) | `#EDF3F8` | | **Hover background** | Background on hover (can be a gradient) | No hover change | | **Border color** | Outline color of the question buttons (can be a gradient) | None | | **Border width** | Outline thickness (in pixels) | `1` | | **Border radius** | Corner rounding of the question buttons (in pixels) | `32` | | **Layout** | `Carousel` (sideways-scrolling row) or `Stacked` (up to 4, one below the other) | `Carousel` | | **Use the same layout on mobile** | Uncheck to choose a separate **Mobile layout** | On | The font size and line height are inherited from the **Message Font Size** and **Message Line Height** settings in the Widget Style section. A live preview appears on the right side of the settings panel so you can see your changes in real time before saving. {% hint style="warning" %} These styling settings only apply to suggested questions and catalog suggestions (see section 5). [Icebreakers](/docs/features/chat-widget/icebreakers.md) have their own separate styling configured on the Icebreakers page. {% endhint %} *** ### 5. Catalog suggestions as customers type As a customer types, Alhena can suggest terms from your product catalog in the message box. For example, typing *sof* can suggest **Sofas** or **Sofa Beds**. Tapping one sends it. Completions use your suggested question styling. To turn them on: 1. Navigate to **Integrations > Website > Configure Settings**. 2. Expand the **Suggested questions** accordion. 3. Toggle **Suggest catalog terms as customers type** to **On** (off by default). 4. Optionally adjust: * **Keep suggesting after the first word**: Off by default. When on, later words get completions too, and tapping one adds it to the message instead of sending it. * **Match common synonyms**: On by default. Matches synonyms, like *couch* for **Sofas**. 5. Click **Save changes**. {% hint style="info" %} Catalog suggestions need a connected product catalog. {% endhint %} *** ### 6. Saving & going live Style changes are saved when you click **Save changes** in the widget settings panel. The Suggested Questions Agent starts generating questions immediately after being enabled — no additional setup is required. Refresh your website in an incognito window to verify the updated styles.