> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suggested questions

> Enable and display suggested questions in your Ask AI experience.

export const SearchQuery = () => <Tooltip tip="The text users enter into a search box. In the Search API, this corresponds to the query parameter. A search query is often used with filters, facets, and other parameters, but these aren't part of the query text itself.">
    search query
  </Tooltip>;

export const Records = () => <Tooltip tip="A record is a searchable object in an Algolia index. Each record consists of named attributes." cta="Algolia records" href="/doc/guides/sending-and-managing-data/prepare-your-data#algolia-records">
    records
  </Tooltip>;

export const Index = () => <Tooltip tip="An Algolia index is a searchable dataset that consists of records and configuration settings. These settings define how the records are searched and ranked.">
    index
  </Tooltip>;

export const Facet = () => <Tooltip tip="An attribute in your records that lets users filter or group results (for example, by color, brand, or price)." cta="Faceting" href="/doc/guides/managing-results/refine-results/faceting">
    facet
  </Tooltip>;

export const Application = () => <Tooltip tip="An Algolia application is a self-contained environment with its own indices, configuration, and API keys. Applications don't share data or settings with each other.">
    application
  </Tooltip>;

<Note>
  Ask AI is part of [Agent Studio](/doc/guides/algolia-ai/agent-studio)
  and isn't available as a standalone feature for new applications.
  Use these docs for existing Ask AI implementations.
  Migration guides will be added when available.
</Note>

Suggested questions help guide users toward common or helpful queries and improve overall engagement.
They appear in your Ask AI interface as clickable prompts that users can select to get started quickly.

## Getting started

You can set up suggested questions during assistant creation or from the assistant analytics view:

<Tabs>
  <Tab title="During assistant creation">
    When creating a new Ask AI assistant,
    the last (optional) step lets you add suggested questions directly in the setup flow.
    This is the quickest way to add initial suggestions before launching your assistant.

    <img src="https://mintcdn.com/algolia/n_gdBwT_QFZcudWB/doc/guides/algolia-ai/askai/guides/create_assistant_flow.png?fit=max&auto=format&n=n_gdBwT_QFZcudWB&q=85&s=9e650389ef3382873416e355bdd11c08" alt="Screenshot of the suggested questions setup during assistant creation" width="1891" height="945" data-path="doc/guides/algolia-ai/askai/guides/create_assistant_flow.png" />

    You can add up to three questions that will be active immediately once your assistant is created.
  </Tab>

  <Tab title="From the assistant analytics view">
    For existing assistants, you can manage suggested questions from the Analytics view.
    This approach is data-driven, allowing you to select questions based on actual user behavior and performance metrics.

    1. Open your assistant's Analytics page and locate the **Active Suggestions** section.

           <img src="https://mintcdn.com/algolia/n_gdBwT_QFZcudWB/doc/guides/algolia-ai/askai/guides/askai-suggested-questions-analytics.png?fit=max&auto=format&n=n_gdBwT_QFZcudWB&q=85&s=f0596439e94422bd1e4536bd82d77071" alt="Screenshot of the active suggested questions section in the analytics view" width="1902" height="948" data-path="doc/guides/algolia-ai/askai/guides/askai-suggested-questions-analytics.png" />

    2. Click **Edit Questions** to open the Suggested Questions Manager.

           <img src="https://mintcdn.com/algolia/n_gdBwT_QFZcudWB/doc/guides/algolia-ai/askai/guides/suggested_questions_view.png?fit=max&auto=format&n=n_gdBwT_QFZcudWB&q=85&s=16ed64723e0d26a0ec6461c919551bdc" alt="Screenshot of the suggested questions manager interface" width="1891" height="950" data-path="doc/guides/algolia-ai/askai/guides/suggested_questions_view.png" />

    3. From there, you can drag and drop questions from a pool of user-submitted queries.
       Each question shows the number of interactions and any thumbs up or thumbs down feedback.

    4. Move up to three questions into the **Active Suggested Questions** section by **Publishing** or **Unpublishing** questions - these will appear in your front-end UI.

           <img src="https://mintcdn.com/algolia/n_gdBwT_QFZcudWB/doc/guides/algolia-ai/askai/guides/question_actions.png?fit=max&auto=format&n=n_gdBwT_QFZcudWB&q=85&s=8cade45c12589825aebfa8cce38cf1b9" alt="Screenshot of the 'Suggested questions' page showing active and saved questions with interaction metrics and a drop-down menu for managing questions." width="1891" height="947" data-path="doc/guides/algolia-ai/askai/guides/question_actions.png" />
  </Tab>
</Tabs>

## Index creation

When you add suggested questions, an <Index /> named `algolia_ask_ai_suggested_questions` is automatically created in your Algolia <Application />.
This index is used to retrieve and display suggested questions within your app.

Each suggested question is stored along with its corresponding assistant ID.
On the frontend, these <Records /> are automatically filtered using <Facet /> filters,
ensuring that each assistant only displays its own set of suggested questions.

<Note>
  You shouldn't modify the index configuration or records manually.
  The index is automatically managed by Ask AI to ensure suggested questions work correctly.
</Note>

## Enabling suggested questions

<Note>
  This feature is available in DocSearch v4.3 and later.
</Note>

To enable the suggested questions feature in your app,
update your Ask AI initialization configuration.
This connects your frontend to the `algolia_ask_ai_suggested_questions` index.

Add the following property to your Ask AI configuration: `suggestedQuestions: true`

<CodeGroup>
  ```js JavaScript theme={"system"}
  docsearch({
    // ...
    askAi: {
      assistantId: 'YOUR_ALGOLIA_ASSISTANT_ID',
      suggestedQuestions: true,
    },
  });
  ```

  ```jsx React theme={"system"}
  <DocSearch
    // ...
    askAi={{
      assistantId: 'YOUR_ALGOLIA_ASSISTANT_ID',
      suggestedQuestions: true,
    }}
  />
  ```
</CodeGroup>

Once enabled, your app will automatically retrieve and display suggested questions relevant to each assistant.

For more configuration options and examples, see the [DocSearch API reference](https://docsearch.algolia.com/docs/api/#askai).

## Display on the frontend

Once the feature is enabled, suggested questions automatically appear in your Ask AI user interface.
You can customize their placement, layout, and styling to align with your app's design system and user experience.

<img src="https://mintcdn.com/algolia/n_gdBwT_QFZcudWB/doc/guides/algolia-ai/askai/guides/docsearch_modal.png?fit=max&auto=format&n=n_gdBwT_QFZcudWB&q=85&s=8f2f3c7d47b01353a28e5d8274f9995a" alt="Screenshot of suggested questions displayed in the Ask AI interface" width="1919" height="887" data-path="doc/guides/algolia-ai/askai/guides/docsearch_modal.png" />

## Generating answers from clicks

When a user clicks a suggested question,
Ask AI automatically generates and displays a relevant response:
just as it would for a manually entered <SearchQuery />.
This creates a seamless experience for your users,
letting them discover answers quickly with a single click.
