# Suggest keywords

### What is the Feature

A smart suggestion system that automatically presents relevant keywords/tags when customers write product reviews. Instead of writing lengthy descriptions, customers can select from pre-defined tags that accurately describe their experience.

### Benefits

* Save your customers time when writing reviews
* Increase review completion rates by making the process easier
* Ensure more detailed reviews by providing relevant prompts
* Maintain consistency in review language across your store

### Steps to configure

{% stepper %}
{% step %}

#### Access Suggested Keywords settings

* Go to Display Reviews
* Click Submit Form
* Navigate to Suggest Keywords section
  {% endstep %}

{% step %}

#### Add keywords for each rating

* Click to expand the rating level you want to add keywords to (1-5 stars)
* Enter your desired keywords in the text field
* Press Enter after each keyword to add it
* Repeat for each star rating level
  {% endstep %}

{% step %}

#### Save your changes

* Review your keywords for each rating level
* Click Save at the top of the page to apply your changes
  {% endstep %}
  {% endstepper %}

{% embed url="<https://app.arcade.software/share/hJr5TaaumraNwv9Tx3s9>" %}
Air Reviews - Suggest keywords
{% endembed %}

### Best practices for keywords

* Keep phrases short and specific
* Use positive phrases for 4-5 star ratings (e.g., "excellent quality", "highly recommend")
* Use constructive phrases for 1-3 star ratings (e.g., "needs improvement", "shipping delay")
* Include common product attributes relevant to your store
* Limit to 5-7 keywords per rating to avoid overwhelming customers

### How customers see your keywords

After configuration, when customers leave a review:

1. They select a star rating
2. Your pre-defined keywords appear as clickable suggestions
3. Clicking a keyword automatically adds it to their review text
4. Customers can still write their own text in addition to using keywords

### Conclusion

The Suggest Keywords feature is designed to make reviewing products simpler while ensuring valuable feedback for both merchants and future shoppers. By combining quick-select tags with optional detailed comments, you can provide comprehensive product feedback in just a few clicks. Remember, the most helpful reviews use a mix of suggested keywords and personal experiences to give other shoppers a clear picture of the product.


---

# 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://help.airreviews.io/display-reviews/submit-form/suggest-keywords.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.