> For the complete documentation index, see [llms.txt](https://help.airreviews.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.airreviews.io/display-reviews/review-popup.md).

# Review popup

### **1. Enable Review popup**

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

Locate the "**Review popup**" feature under the **Advanced** group, and click "**Setup**".

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

Toggle the switch in the page header (next to the **Review popup** title) to enable the widget.

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

### **2. Settings**

#### **2.1 Page to show**

Pick which pages the popup appears on. Tick any combination of:

* **Home page**
* **Collection page**
* **Cart page**
* **Product page**
* **Custom** — enter specific page URLs to target instead of (or on top of) the standard pages.

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

#### **2.2 Show review image**

Tick to display the customer's review photo inside the popup. Applies to both mobile and desktop.

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

#### **2.3 Show on mobile**

<figure><img src="/files/6jEmBB7GsEDwVJEcPAAK" alt=""><figcaption></figcaption></figure>

Toggle on to display the popup on mobile devices, then choose:

* **Popup style** — pick one of two preset card layouts.
* **Mobile position** — pick where on the screen the popup anchors (one of two positions).

#### **2.4 Show on desktop**

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

Toggle on to display the popup on desktop, then choose:

* **Popup style** — pick one of four preset card layouts.
* **Desktop position** — pick where on the screen the popup anchors (one of four positions, e.g. bottom-left, bottom-right).

### **3. Advanced settings**

Open **Advanced settings** at the bottom of the page to fine-tune visibility and styling.

* **Excluded pages** — paste page URLs (one per line) where the popup should NOT appear. Useful for hiding the popup on checkout, policy, or landing pages even if their type is enabled in section 2.1.
* **Custom CSS** — paste your own CSS to style the popup beyond the built-in style presets. Best for merchants comfortable with CSS.

***

*This guide aims to provide a clear and easy-to-follow process for setting up and customizing the Review Popup on your Shopify site, ensuring your customer reviews are both seen and impactful.*


---

# 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 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/review-popup.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.
