# Write review

{% hint style="info" %}
This feature is available for the **Pro** plan and above
{% endhint %}

### What is "Write review" feature?

The Write Review feature is an engagement tool that rewards customers for submitting product reviews on your store. This feature integrates with various popular review apps to automatically award points or rewards when customers share their product experiences.

### Why do you need this feature?

Encouraging customers to submit reviews is a great way to build trust and showcase user-generated content. By offering rewards for submitting a review, you can incentivize customers to share their feedback while growing your loyalty program. In this guide, we'll walk you through how to set up and manage the Review rewards program, making it easy for your customers to earn points for sharing their experience.

### How to set up this feature

{% stepper %}
{% step %}
**Get access to "Write review"**

Choose **Reward programs** -> **Earning programs** -> Click **Add rule** -> Choose **Write review**

{% embed url="<https://app.arcade.software/share/c9DMIX6DEWk1n4Hbtg5Y>" %}
{% endstep %}

{% step %}
**Choose review app**

Select one review app to integrate with

<figure><img src="/files/2gB4W6XivOwgZzFIuWnA" alt=""><figcaption></figcaption></figure>

See how to integrate with each of our supported review apps as below:

|       App       |                                                              Post                                                             |
| :-------------: | :---------------------------------------------------------------------------------------------------------------------------: |
| Klaviyo reviews |                      [Joy and Klaviyo reviews](/integrations/product-reviews/joy-and-klaviyo-reviews.md)                      |
|   Air Reviews   |                              [Joy and Air reviews](/integrations/product-reviews/air-reviews.md)                              |
|     JudgeMe     |                              [Joy and JudgeMe](/integrations/product-reviews/joy-and-judge.me.md)                             |
|       Loox      |        [Joy and Loox](https://help.joy.so/notifications/integrate-with-shopify-flow/shopify-flow-loox-and-joy-loyalty)        |
|      Okendo     |      [Joy and Okendo](https://help.joy.so/notifications/integrate-with-shopify-flow/shopify-flow-okendo-and-joy-loyalty)      |
|      Tydal      |               [Joy and Tydal](https://help.joy.so/notifications/integrate-with-shopify-flow/shopify-flow-tydal)               |
|    Reviews.io   |  [Joy and Reviews.io](https://help.joy.so/notifications/integrate-with-shopify-flow/shopify-flow-reviews.io-and-joy-loyalty)  |
|     Stamped     |    [Joy and Stamped](https://help.joy.so/notifications/integrate-with-shopify-flow/shopify-flow-stamped.io-and-joy-loyalty)   |
|   Fera Reviews  |                         [Joy and Fera reviews](/integrations/product-reviews/fera-product-reviews.md)                         |
|  Yotpo Reviews  |                        [Joy and Yotpo reviews](/integrations/product-reviews/joy-and-yotpo-reviews.md)                        |
| Groware reviews | [Joy and Growave reviews](https://help.joy.so/notifications/integrate-with-shopify-flow/shopify-flow-growave-and-joy-loyalty) |
|  Rocket reviews |                                                     Joy and Rocket reviews                                                    |
|  {% endstep %}  |                                                                                                                               |

{% step %}
**Set up "Write review"**

**a. For Shopify-flow-powered integrations**

**Rule information**: Set up your review program information

* **Program name**: Enter the name of the earning reward program
* **Description**: Describe your program to resonate with your customers

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

**Program rule:** Follow the guide and click **Create Shopify flow** to activate automatic point rewards

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

**b. For direct API-integrated review apps**

**Rule information**: Set up your review program information

* **Program name**: Enter the name of the earning reward program
* **Start date** and **End date**: Define the activity duration for your program

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

**Reward rule:** Choose amount of points to reward customers for submitting reviews

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

**Anti-cheat:** Keep your program fair with these safeguards:

* **Minimum number of characters**: Set minimum character count to control quality of your program
* **Set an earning points limit**: Limit how often points can be earned

Remember to press **Turn on** to activate your anti-cheat protection

<figure><img src="/files/ocYuhIoU2yryyiBarG6E" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Save** your changes and press **Turn on** Write review program

<figure><img src="/files/JwfG5Seo6WyHFuamAabU" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Apply the program to specific products or collections <a href="#review-program-scope" id="review-program-scope"></a>

By default, every product review on your store earns points. If you want to reward reviews only on a curated catalog — for example, to promote a new collection — restrict the program with the **Program applies to** setting.

**Where to find it:** When creating or editing a Write review program, scroll to **Program applies to** and pick one of:

* **All products** *(default)* — keeps current behavior; every review earns.
* **Selected products** — only reviews on the products you pick earn points.
* **Selected collections** — only reviews on products inside the chosen collections earn points.
* **All products except selected collections** — reviews earn on everything except the collections you exclude.

The same setting is also available on **Milestone → Number of reviews** steps inside [Mixed milestone](/reward-programs/milestone/mixed-milestone.md), so a milestone "Write 3 reviews" can also be limited to a specific catalog.

**Edge cases:**

* If a product or collection on the list is later deleted in Shopify, that entry is automatically dropped from the program — the rest of the list keeps working.
* Customers reviewing products outside the scope simply do not earn — no error or warning is shown.

### FAQs

#### Can I have an anti-cheat for Shopify-Flow-powered integration like with direct API integrations?

Unfortunately, we cannot control that. It depends on whether the trigger from the reviews app providing that mechanism or not.

#### Can I reward more if the review includes images or video?

Yes, you can. With direct API integration, we have an option for that and it is on Advanced.

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

However, with Shopify-Flow-powered integrations, it depends on the trigger include a variable for you to set the condition or not.


---

# 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.joy.so/reward-programs/earning-programs/write-review.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.