> For the complete documentation index, see [llms.txt](https://help.joy.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.joy.so/on-site-content/branding/widget-v4/joy-and-judge-me-reviews.md).

# Judge.me Reviews in the Unified Widget

{% hint style="info" %}
Requires the **Unified Widget** and Joy connected to **Judge.me**.
{% endhint %}

### Overview

Add a **Reviews** tab to your Unified Widget so customers can view the reviews they've written and submit new ones — without leaving the loyalty widget. Joy renders the entire experience in your brand styling, while review data is served by Judge.me behind the scenes. Customers earn points through your existing **Write a review** earning program.

#### What customers see

* Each review with its date, product (and thumbnail), star rating, review text, status (**Published** or **Pending**), and points earned
* A **Write a review** action that opens an inline form inside the widget — no redirect
* An empty state prompting first-time reviewers to write a review and earn points

> **Note:** The Reviews tab shows only the current customer's own reviews. It doesn't replace the Judge.me reviews widget on your product pages.

***

### Before you start

* Your store uses the **Unified Widget** (not Classic).
* Joy is connected to **Judge.me**. If you haven't yet, follow [Joy and Judge.me](https://help.joy.so/integrations/product-reviews/joy-and-judge.me) first — connect the integration and select Judge.me in your Write review program. Judge.me's **Awesome plan or above** is required for API access.

***

### How to add the Reviews tab

{% stepper %}
{% step %}

### Open the Unified Widget

Go to **On-site content → Widget → Unified Widget**.
{% endstep %}

{% step %}

### Turn on the Reviews extension

In the **Extensions** section, turn on the **Reviews** toggle. Once enabled, **Reviews** appears automatically in the **Footer menu** list — no manual add needed.
{% endstep %}

{% step %}

### Choose your review app

In the **Reviews extension settings**, select the review app you want to connect as the provider — choose **Judge.me**.
{% endstep %}

{% step %}

### Edit the label and star rating

In the **Footer menu**, open the Reviews item to edit its **label** and **star rating** display so they match your brand.
{% endstep %}

{% step %}

### Save and publish

Save your changes. The Reviews tab appears in the live widget for logged-in customers.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Reviews appear after a customer is identified (logged in). Points show once the review is approved in Judge.me — pending reviews display without points until then. This works alongside the existing [Write review earning program](https://help.joy.so/reward-programs/earning-programs/write-review).
{% endhint %}


---

# 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.joy.so/on-site-content/branding/widget-v4/joy-and-judge-me-reviews.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.