Migration Rest Portal

Build Apps

Go Headless

Client

API Preview

Develop Websites

REST

GraphQL (Alpha)

# About the Reviews API

<div style="background-color: #FEF1D1; padding: 18px 24px; border-radius: 6px; border: 1px solid #FDB10C; box-sizing: border-box; display: inline-block">
    <b>Developer Preview</b>
    <br/>
    <span>APIs in <a href="fallback::https://www.wix.com/velo/reference/api-overview/developer-preview">Developer Preview</a> are subject to change and are not intended for use in production.<br/><a href="fallback::mailto:velo-preview-feedback@wix.com">Send us</a> your suggestions for improving this API. Your feedback is valuable to us.</span>
</div>

With the Reviews API you can manage reviews for a site's services, content, or products. The review object holds the content of the review, a rating score, images or video media, and information about the author. Learn more about [Wix Reviews](fallback::https://support.wix.com/en/article/wix-stores-adding-and-setting-up-wix-reviews).

The Wix Reviews API allows the site to:

- Import reviews from other sites and export reviews to other sites.
- Retrieve and display positive review data. Use the [Media API](portalId::b85dea5b-341b-493b-b99e-4d4ca12baaa2resourceId::f4c500a3-7b31-4de2-a69d-b9aa2e9731a7slug::setup*fallback::https://dev.wix.com/docs/sdk/api-reference/media/setup) to retrieve associated review media.
- Retrieve negative review data enabling site owners to respond effectively.

## Moderation

If moderation is turned on, reviews are checked for content that requires moderation. If moderation is required, the review remains pending until the site owner rejects or approves it in the site's [Dashboard](fallback::https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Freviews/pending). 
The site owner can configure moderation settings in the site's [Dashboard](fallback::https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Freviews/settings/moderation).  Learn more about [managing reviews](fallback::https://support.wix.com/en/article/wix-stores-managing-wix-reviews).

## Before you begin
It’s important to note the following points before starting to code:

- Every review needs a contact. If the author is already listed as a contact, use either [Create Review](fallback::#createReview) or [Create Review and Contact](fallback::#createReviewAndContact). If the author is not yet a site contact, use [Create Review and Contact](fallback::#createReviewAndContact).  
- A review author is limited to one review per entity. Duplicate reviews receive an error response.
- Replying to a review is available only in the site owner's [Dashboard](fallback::https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Freviews/pending).

## Terminology

- **Entity**: The entity to review. For example, a Wix Stores product.  
- **Namespace**: The Wix module that the Reviews API is integrated with. Currently only Wix Stores.
- **Rating**: The rating score for the review item. An author can give a rating score between 1 and 5. The rating is displayed with the site review.  
- **Helpfulness**: Helpfulness is the overall helpfulness score calculated by subtracting Found Unhelpful from Found Helpful. Site visitors can indicate whether a review was helpful or not.  
- **Reply**: A direct reply to a review that was left on the site. The reply is displayed with the review.