---
title: "Add the write review button to Shopify order status pages"
description: "With this feature, customers can leave reviews without returning to the product page, helping you collect more verified post-purchase reviews."
url: https://docs.ryviu.com/en/articles/183-add-the-write-review-button-to-shopify-order-status-pages
collection: "Shopify 2.0 OS"
updated: 2026-11-09
language: en
---

# Add the write review button to Shopify order status pages

With this feature, customers can leave reviews without returning to the product page, helping you collect more verified post-purchase reviews.

This article provides step-by-step instructions for adding and customizing the **Write a review** button on Shopify order status pages.

## Customer experience

Customers can:

-   Write reviews directly from the **Order status** page.
    
-   Review **each purchased product** separately.
    
-   Review **different variants** individually.
    
-   Upload **multiple photos** with preview support.
    
-   Edit previously submitted reviews.
    

![](https://staticfiles.gleap.io/ghelparticle/iyHkBnS0Wu1ypfuffgAXIgykwe6HjrFRny2SvY7bJfxeQF7pX5qWGCsQrt89gUsSPD4E8wPphxA.webp)

The button label changes automatically depending on the review status, for example:

-   **Write a review** – No products have been reviewed yet.
    
-   **Write a review (2 left)** – There are still **2 products** waiting for reviews.
    
-   **View your reviews** – Reviews have been submitted for **all products in the order**.
    

## How to add and customize the Write a review button

1.  How to add and customize the Write a review button
    
2.  From your store admin, navigate to **Sales Channels**\> **Online Store.**
    
3.  Click the **Customize** button in your current theme.
    
4.  Click on the **Homepage** menu at the top center, select **Checkout and Customer accounts.**
    
    ![](https://staticfiles.gleap.io/ghelparticle/oMaQmsa6pkFuJ3OnpdLNCZVv7ztEI4HEICuCLFFXtcXvOsSZknL0mVG5v2ApSgPk4a80GB638Uz.png)
5.  Click **Checkout** menu at the top center, select **Order status.**
    
    ![](https://staticfiles.gleap.io/ghelparticle/LHG6yJ2xmszksMRKfvSVKSvkMXB2oqE13v0QMe8xWFPvWahit4mXzcYaVnmhTgu4czX1nl1wbqd.png)
6.  Click **\+ Add block** in the menu in the left sidebar > choose **Reviews - Order status page.**
    
7.  **Optional:** Drag the block to your preferred position.
    
    ![](https://staticfiles.gleap.io/ghelparticle/ymlVwRUnzpRYgFl7RoCaGzJX3WWe9XcOyFnv9IsrVxfeiqbywYLFwG8ETVeaLkNepSRSXNOIL6v.png)
8.  Customize the button text and other labels if needed.
    
9.  Click **Save**.
    

You can customize texts such as:

![](https://staticfiles.gleap.io/ghelparticle/D2eWDtFf9JrMlLKJG7JWnm5iJvEFeqkkTK6vIE4oFDpMtXvnAFvKSPo2JEPCgOR0DyWYCjjwesV.png)

-   Write Button
    
-   Title Modal
    
-   Review Title
    
-   Review content
    
-   Submit Button
    
-   Success Submit
    
-   Error Submit
    

## Configure settings, rewards, and translations

### Review settings

Customers can write reviews according to the [**Request review automation**](https://docs.ryviu.com/en/articles/129-how-to-set-up-automated-review-request-emails.md#heading-1-step-2-enable-sending-request-review) settings configured in Ryviu.

-   **Fulfilled** – customers can write reviews after the order has been fulfilled.
    
-   **Delivered** – customers can write reviews after the order has been marked as delivered.
    

For stores on the **Free plan**, the default condition is **Delivered**.

### Rewards

> **Info:** Reward features are available **only for Ryviu paid plans**.

If **Discount for Reviews** or the **Loyalty add-on** is enabled, customers can receive rewards after submitting a verified review.

**Discount for Reviews**

Customers may:

-   receive a **discount code immediately** after submitting the review, or
    
-   receive the code **by email after the review is approved**, depending on your store settings.
    

**Loyalty points**

If the Loyalty add-on is enabled for your store and the Write a review [earning method](https://docs.ryviu.com/en/articles/191-earn-programs.md) is activated, customers can earn loyalty points for submitting a review, including VIP bonus points if configured. By default, the reward is granted once per customer, unless the reward limit is set to Unlimited.

### Translations

This feature supports **9 languages**, including English, French, Deutsch, Spanish, Italiano, Japanese, Portuguese, Vietnamese, and Chinese.

All customer-facing texts can be edited directly from the **Block settings**.

## What happens after a customer submits a review

After a review is submitted, Ryviu automatically:

-   Saves the review with **Source = Order**, including the purchased variant, customer country, and language;
    
-   Sends **in-app notifications** for new reviews and edited reviews;
    
-   Sends an **admin email notification** if **New review notification** is enabled.
    
-   Updates the product **rating metafields** so storefront widgets display the latest rating automatically;
    
-   Triggers the **Shopify Flow – Create reviews** event;
    
-   Marks the order as **reviewed**, so request review emails for that order are no longer sent.
    

**Need help?**

Get in touch with our support team through [live chat](https://docs.ryviu.com/en/articles/101-support.md) or email at [info@ryviu.com](mailto:info@ryviu.com)**.** We're here to help!​