> ## Documentation Index
> Fetch the complete documentation index at: https://docs.winnerr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviews on your Winnerr site

> Add the agentReviews block to any Growth Studio site to display your published reviews with star-rating structured data.

If you build a website in Growth Studio (Winnerr's site builder), you can embed your published client reviews directly on any page using the **Reviews** (`agentReviews`) block. The block pulls the same governed set of reviews that appear on your public reputation profile — PUBLISHED status, PUBLIC consent tier, in the order you set.

## How it works

When a Growth Studio page is rendered, the server checks whether the page config includes a visible `agentReviews` block. If it does, the server loads your published reviews from the database and injects them into the page HTML before it reaches the browser. There is no cross-origin iframe, no third-party script, and no extra API call from the visitor's browser.

The block renders in the same trust environment as the rest of your Winnerr site — your brand colors, layout, and compliance footer all apply.

## Add the Reviews block to a page

1. Go to **Growth OS → Sites** and open the site you want to edit.
2. Add a new block and choose **Reviews** from the block library.
3. Choose a variant (see below) and configure the heading text.
4. Save and publish the page.

## Block variants

| Variant            | What it renders                                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Grid** (default) | Two-column card layout — good for mid-page social proof sections.                                                |
| **List**           | Single-column stacked cards — best for narrow columns or mobile-first pages.                                     |
| **Carousel**       | Horizontally scrollable review cards — good for homepage sections.                                               |
| **Badge**          | Compact trust strip showing aggregate rating only (no individual review cards) — ideal for footers and sidebars. |

## Block configuration

Each `agentReviews` block accepts:

| Setting       | Purpose                                              | Default            |
| ------------- | ---------------------------------------------------- | ------------------ |
| `heading`     | Section heading shown above the reviews.             | "What clients say" |
| `subheading`  | Optional sub-heading.                                | Omitted            |
| `maxReviews`  | Maximum number of review cards to show (1–50).       | 12                 |
| `accentColor` | Hex color for accent elements (e.g. `#2563eb`).      | Site theme accent  |
| `hidden`      | Set to `true` to hide the block without removing it. | `false`            |

## Structured data (star ratings in search)

The `agentReviews` block emits [Schema.org](https://schema.org) `RealEstateAgent` JSON-LD structured data on any page that includes it. The structured data includes:

* `@type: RealEstateAgent` with the agent's display name and public profile URL (when the profile is published and indexable).
* `aggregateRating` with `ratingValue`, `reviewCount`, `bestRating` (5), and `worstRating` (1) — this is what search engines use to display star ratings in results.
* Individual `Review` items (up to 20) with author name, rating, and review text.

This structured data only renders when at least one published review exists and the page is published. The Badge variant includes structured data as well (aggregate only).

## What the block shows

The block only ever renders reviews that are:

* Status: `PUBLISHED`
* Visibility: `PUBLIC`

Consent flags are honored: a review without `permissionUsePhoto` renders without the photo; a review without `permissionUseName` shows initials only. No draft reviews, pending reviews, or internal reviews are ever included.

Reviews are ordered by `sortOrder` (ascending), then `approvedAt` (most recent first), then `createdAt`. This matches the order on your public reputation profile.

## Link to your full profile

When your public reputation profile is published and marked indexable, the block includes a link to your full profile (`/r/<your-slug>`) so visitors can read all your reviews. When the profile is a draft or not indexable, the link is omitted.

## Prerequisites

* At least one testimonial must be in `PUBLISHED` status with `PUBLIC` visibility before the block shows content. The block renders nothing (no empty state shown to site visitors) until at least one review is available.
* The Growth Studio site must be published.

## Related

* [Reputation overview](/reputation/overview) — the full Reputation Studio flywheel.
* [Testimonials](/reputation/testimonials) — approve and publish reviews so they appear in the block.
* [Public profile](/reputation/public-profile) — your standalone `/r/<slug>` reputation page.
* [Reviews widget](/reputation/widgets) — embed reviews on external sites you don't build in Winnerr.