# Submit form

## Submit form

### **1. Open the Submit form settings**

Head to "**Display reviews**" section on the left side menu.

Locate the "**Submit form**" feature under the **Basic** group, and click "**Setup**" to start the process.

<figure><img src="/files/aFUs0mXRxInOTEvzBIRM" alt=""><figcaption></figcaption></figure>

### 2. Review submit form

#### **2.1 Choose preset**

Pick the display style for the form on your storefront. Two options are available:

<figure><img src="/files/jbStV1WQZQLXL0XGDR4d" alt=""><figcaption></figcaption></figure>

* **Popup** — the submit form appears in a popup window when a customer clicks to leave a review.

<figure><img src="/files/JZb3CLvgIp8qhkP2WU8t" alt=""><figcaption></figcaption></figure>

* **Collapsible** — the submit form expands inline below the review block.

<figure><img src="/files/jt5kWkPgtu7WOl30qPdm" alt=""><figcaption></figcaption></figure>

#### **2.2 Colors setup**

Match the form to your store's theme using these five color fields:

* **Background color** — the background of the submit form.
* **Text color** — the text inside the form.
* **Submit button color** — the background of the **Submit** button.
* **Submit button text color** — the label on the **Submit** button.
* **Validations text color** — inline validation and error messages (e.g. "This field is required").

<figure><img src="/files/isQCcOJkH9xe4B1vF09a" alt=""><figcaption></figcaption></figure>

#### **2.3 Show policy**

Tick the **Show policy** checkbox to display a link to your store's review/privacy policy below the form. Useful if your store needs to disclose how customer data is used.

### 3. Suggest keywords

Provide customers with popular review phrases for your products to reduce the time required to leave a review. Toggle on to enable, then configure the phrases on the dedicated page.

> See the full guide: [Suggest keywords](https://help.airreviews.io/display-reviews/submit-form/suggest-keywords).

### 4. Dynamic question

Show tailored follow-up questions based on the rating a customer selects — for example, ask different things for 5 stars vs. 2 stars — to lift the quality of the feedback you collect. Toggle on to enable, then build the question set on the dedicated page.

> See the full guide: [Dynamic question](https://help.airreviews.io/display-reviews/submit-form/dynamic-question).

### 5. Advanced settings

Open **Advanced settings** to fine-tune what the form requires from shoppers and how it looks beyond the color fields.

* **Mark content optional** — when ticked, customers can submit a review without writing any text (only the rating is required). Leave unticked to keep the feedback field mandatory.
* **Custom CSS** — paste your own CSS to fine-tune the form's appearance beyond the color settings above. Best for merchants comfortable with CSS.

***

*You're all set! Your review submission form now reflects your store's theme, making it a seamless part of the customer experience.*


---

# 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.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.
