> For the complete documentation index, see [llms.txt](https://docs.moregoodreviews.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moregoodreviews.com/platform/review-pages/review-suggestions.md).

# Suggestions

Enable AI review suggestions so customers can generate a starting point they can edit.

AI Review Suggestions help customers get started on a review. The feature is off by default. When you enable it, customers who leave a 4 or 5 star rating see a **Generate** button next to the review field. One click produces several suggestions they can pick from, edit, or ignore. The review should still be their own words.

***

### Where to Find It

Open a review page and click **Feedback Form** in the sidebar. Below the fields table, you'll see **AI Review Suggestions**, which you can turn on or off for that page. You can also choose pages in bulk from **Settings → AI Tools → Review Suggestions**.

***

### Enabling AI Review Suggestions

Set **Review Suggestions** to **Enable** and click **Save**. Suggestions are now active on that review page. You can enable them on some pages and leave them off on others. Each review page has its own setting.

{% hint style="info" %}
Before AI Review Suggestions work, add a **Business Description** in **Settings → Project** (at least 50 characters). Then set language, keywords, and custom instructions in **Settings → AI Tools**. See [AI Tools](/platform/ai-tools.md).
{% endhint %}

***

### What Happens When It's Enabled

When AI Review Suggestions are enabled on a review page, here's what customers see:

1. **They open your review page** and select a rating (e.g., stars or faces).
2. **If they choose a positive rating** (4 or 5 stars) and your page shows a review field, a **Generate** button appears next to it.
3. **They click Generate** and a window opens with several review suggestions. Each suggestion is a starting point based on your project settings.
4. **They can**:
   * **Select** – Put a suggestion in the review field so they can edit it.
   * **Copy** – Copy a suggestion so they can edit it before using it elsewhere.
   * **Regenerate** – Get a new set of suggestions.
5. **They submit** their review as usual. They can edit any suggestion before submitting.

{% hint style="warning" %}
Suggestions are a starting point. Customers should edit the text so it matches their experience. Do not post a suggestion to Google for them. See [Google Review Guidelines](/platform/google-review-guidelines.md).
{% endhint %}

{% hint style="info" %}
The Generate button only appears when customers are writing a review on your page. If your page redirects them away right after they pick a rating, they will not see the button.
{% endhint %}

***

### When the Button Does Not Appear

The Generate button does not show when:

* The customer selects a low or neutral rating (below 4 stars).
* The review page redirects customers to an external site immediately after they choose a rating.
* The review page does not include a review text field for that rating.
* AI Review Suggestions are disabled for that review page.

***

### Tips for Better Results

* **Configure your project first** – A clear business name and description in **Settings → Project** help the AI produce relevant, on-brand starting points.
* **Use with links, not redirects** – If you want customers to stay on your page long enough to write and edit a review, use [Links](/platform/review-pages/links.md) instead of [Redirects](/platform/review-pages/redirects.md).
* **Enable on high-traffic pages** – Turn on AI Review Suggestions for review pages where you send the most customers, such as email, SMS, or QR codes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.moregoodreviews.com/platform/review-pages/review-suggestions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.