Suggested questions

Enable and display suggested questions in your Ask AI experience.

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:

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.

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

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.

   

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

   

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.

   

Index creation

When you add suggested questions, an named algolia_ask_ai_suggested_questions is automatically created in your Algolia . 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 are automatically filtered using filters, ensuring that each assistant only displays its own set of suggested questions.

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

Enabling suggested questions

This feature is available in DocSearch v4.3 and later.

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

JavaScript

docsearch({
  // ...
  askAi: {
    assistantId: 'YOUR_ALGOLIA_ASSISTANT_ID',
    suggestedQuestions: true,
  },
});

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.

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.

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 . This creates a seamless experience for your users, letting them discover answers quickly with a single click.