> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Wix Reviews Collections

## Article: Wix Reviews Collections

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/wix-app-collections/wix-reviews-collections.md

## Article Content:

# Wix Reviews Collections

This article explains the fixed permissions and field structure for the Wix Reviews [Reviews](#reviews) collection.

> **Note:** This collection is a system collection, so you can't change its permissions in the CMS.

<blockquote class="tip">

**Tip:**
Before continuing, make sure you've read [Working with Wix App Collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code.md).

</blockquote>

## Reviews

This section explains the permissions and fields available in the Reviews collection.

To use the Reviews collection in code, refer to it as `Reviews/Reviews`.

::::tabs
:::REST_TAB
```
curl -X POST \
  'https://www.wixapis.com/wix-data/v2/items/query' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "dataCollectionId": "Reviews/Reviews",
    "query": {}
  }'
```
:::
:::SDK_TAB
```js
import { items } from "@wix/data";

items.query("Reviews/Reviews")
  .find()
  .then((results) => {
    // handle the results
  });
```
:::
::::

<blockquote class="important">

**Important:**
You can query up to 100 items from the Reviews collection. Trying to query more than 100 items by raising the query [limit](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language.md#paging) will result in an error.

</blockquote>

### Permissions

The Reviews collection has the following [permissions](https://support.wix.com/en/article/cms-collection-permissions-overview):

- `read`: `ANYONE`
- `create`: `ADMIN`
- `update`: `ADMIN`
- `remove`: `ADMIN`

### Fields

This section describes each field in this collection and its properties.

> **Note:** This collection contains read-write fields. Some fields are read-only and managed by Wix, while others can be updated in code.

Each field heading shows the field name followed by the field ID in parentheses, in the format "fieldName (`fieldId`)".

The fields are listed in the same order as the collection's default order in the CMS.

#### Namespace (`namespace`)

**Description:** The app you're reviewing. For example, Wix Stores.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`, `ne`

**Read-write:** Yes

#### Entity ID (`entityId`)

**Description:** ID of the entity being reviewed. For example, a Wix Stores product.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-write:** Yes

#### ID (`_id`)

**Description:** Review ID.

**Type:** Text

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`, `ne`

**Read-only:** Yes

#### Content (`content`)

**Description:** Review content.

**Type:** Object

**Can connect to data:** Yes, by content title, body, and rating.

**Can use in dynamic page URL:** No

**Sortable:** Yes, by `rating`

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte` (by `rating`)

**Read-write:** Yes, `rating` only

```json
[
  {
    "title": "Excellent Laptop with Great Features",
    "body": "This laptop excels in speed, battery life, and display quality.",
    "media": [
      {
        "image": {
          "id": "344592895_182127404391791_355010341914573594.jpeg",
          "url": "https://example.com/media/344592895_182127404391791_355010341914573594.jpeg",
          "height": 1976,
          "width": 1572,
          "altText": "laptop.jpeg",
          "filename": "laptop.jpeg"
        }
      }
    ],
    "rating": 4
  },
  {
    "title": "Laptop Video",
    "body": "This video is about the laptop.",
    "media": [
      {
        "video": {
          "id": "video.mp4",
          "Resolution": {
            "url": "https://example.com/media/123456.mp4",
            "height": 1800,
            "width": 1300,
            "poster": {
              "id": "poster.png",
              "url": "https://example.com/media/1233334.mp4",
              "height": 450,
              "width": 325,
              "altText": "laptop.mp4",
              "filename": "laptop.mp4"
            }
          }
        }
      }
    ],
    "rating": 4
  }
]
```

#### Created Date (`_createdDate`)

**Description:** Date and time the review was created.

**Type:** Date and Time

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`

**Read-only:** Yes

#### Updated Date (`_updatedDate`)

**Description:** Date and time the review was last updated.

**Type:** Date and Time

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Author (`author`)

**Description:** A JSON object that describes the author of the review.

**Type:** Object

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

```json
{
  "contactId": "bd9513fb-5400-45fd-9db3-4182c65bc035",
  "authorName": "Jon Smith"
}
```

#### Reply (`reply`)

**Description:** A JSON object that describes the reply to the review.

**Type:** Text

**Can connect to data:** Yes, by the reply's message.

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

```json
{
  "message": "Thanks for the great review!",
  "createdDate": "2023-01-10T15:53:24.347Z",
  "updatedDate": "2023-01-14T17:35:34.456Z"
}
```

#### Found Helpful (`foundHelpful`)

**Description:** Number of people who found the review helpful.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Found Unhelpful (`foundUnhelpful`)

**Description:** Number of people who found the review unhelpful.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Helpfulness (`helpfulness`)

**Description:** Helpfulness score. Calculated by subtracting `foundUnhelpful` from `foundHelpful`.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`

**Read-only:** Yes

#### Moderation (`moderation`)

**Description:** A JSON object that describes the moderation status of the review.

**Type:** Object

**Can connect to data:** Yes, by the moderation's `moderationStatus`.

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`, `ne` (by `moderationStatus`)

**Read-only:** Yes

> **Note:** The `moderationStatus` property has one of the following values:
>
> - `APPROVED`: The review is approved and published.
> - `IN_MODERATION`: The review is pending moderation.
> - `REJECTED`: The review is rejected and deleted from the site.
> - `SUBMITTED`: Initial status of the review before the moderation process.

```json
{
  "moderationStatus": "APPROVED",
  "manuallyChanged": false
}
```

#### Revision (`revision`)

**Description:** Revision number, which increments by 1 each time the review is updated.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Verified (`verified`)

**Description:** Indicates if the review has been verified.

**Type:** Boolean

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** `eq`, `ne`

**Read-only:** Yes

#### Origin (`origin`)

**Description:** Provides information about the origin of the review. Organic reviews are created by site visitors or members. App reviews are created by apps even though a site visitor or member is the author of the review. Apps can't create or update organic reviews.

**Type:** Object

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`, `ne` (by `type`)

**Read-only:** Yes

#### Review Date (`reviewDate`)

**Description:** Date and time when the review was written. This should match the created date, except for reviews imported from another review system.

**Type:** Date and Time

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Relevance Score (`relevanceScore`)

**Description:** Relevance score calculated by the reviews platform based on review content. Used to sort reviews by relevance to the reviewed item.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `urlized`

**Read-only:** Yes

#### Publish Count (`publishCount`)

**Description:** Counts the number of times a review has been published. Reviews require approval before publishing, unless moderation is disabled. When moderation is disabled, reviews are automatically approved and published.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes