# Review widgets

> Create widgets that show your product and company reviews, star ratings, and review summaries on your store.

Breadcrumb: Reviews › Review widgets · Updated: 2026-10-17
Docs index: https://docs.cevoid.com/llms.txt

Review widgets show your reviews and ratings on your store: review lists, carousels, and walls, star ratings, rating summaries, AI summaries, and summaries of your review questions. Each widget shows either product reviews or company reviews.

Navigate to [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets) to manage your review widgets.

| Widget type | What shoppers see | Placement |
| --- | --- | --- |
| Review list | Review cards in a grid, masonry, carousel, ticker, or list, with a rating summary, search, sort, and filters | Section |
| Star rating | Stars, the average rating, and the number of ratings | Element |
| Rating summary | The average rating, stars, and a bar for each star rating | Element |
| AI summary | A paragraph written by AI about what reviewers say | Element |
| Question summary | A summary of reviewers' answers to your product questions, such as fit | Element |

A section is a band of its own on the page. An element is a compact block that sits inside a section, such as under the product title.

## Review widget templates

Every review widget starts from a template, which decides its type, whether it shows product or company reviews, and whether it's dynamic. None of these can change later. A dynamic widget, marked _Dynamic_, fills itself from the page it's on, so one widget serves every product page. Curated widgets show the reviews you select, on any page.

**Product reviews:**

| Template | Type | Reviews of | Made for |
| --- | --- | --- | --- |
| **Dynamic Product Reviews** | Review list | The product on the page | Product pages |
| **Dynamic Collection Product Reviews** | Review list | The products in the collection on the page | Collection pages |
| **Dynamic Category Product Reviews** | Review list | The products in the page's category, or the product's category | Product and category pages |
| **Dynamic Brand Product Reviews** | Review list | The products of the page's brand, or the product's brand | Product and brand pages |
| **Dynamic Product Rating** | Star rating | The product on the page | Under the product title |
| **Dynamic Product Rating Summary** | Rating summary | The product on the page | Beside the product title |
| **Dynamic Product AI Summary** | AI summary | The product on the page | High up on product pages |
| **Dynamic Product Question Summary** | Question summary | The product on the page | Beside the variant picker |
| **Product AI Summary of Selected Reviews** | AI summary | The product reviews you select | Any page |
| **Product Review Highlights Carousel** | Review list | The product reviews you select | The homepage |
| **Product Reviews Ticker Wall** | Review list | The product reviews you select | A reviews page or the homepage |

**Company reviews:** All company templates are curated.

| Template | Type | Made for |
| --- | --- | --- |
| **All Company Reviews** | Review list | A reviews page or an About page |
| **Company Rating** | Star rating | The header or footer |
| **Company Rating Summary** | Rating summary | Any page |
| **Company AI Summary** | AI summary | An About page |
| **Company Review Highlights Carousel** | Review list | The homepage |
| **Company Reviews Ticker Wall** | Review list | Any page |

Curated templates start with all your reviews, except the carousels and ticker walls, which start with 4 and 5 stars. Each template also has its own starting settings: see [Review widget settings](https://docs.cevoid.com/reviews/showcase/review-widget-settings.md).

## How review widgets work

Review widgets follow these rules:

- **One review type:** A widget shows product reviews or company reviews, never both
- **Published reviews only:** Pending, rejected, and hidden reviews never show. Reviews are hidden when you hide a product's existing reviews with the [review blocklist](https://docs.cevoid.com/reviews/manage/review-blocklist.md), and when a product leaves your catalog.
- **Every market:** A widget shows reviews from all your markets, in the shopper's language
- **Star-only ratings:** Reviews with stars and no text, title, or visible photos or videos count toward a widget's average and number of ratings, but widgets don't list them

On [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets), your widgets are grouped in _Product reviews_ and _Company reviews_. Each card shows _Section_ or _Element_, _Dynamic_ for dynamic widgets, and _Live_ or _Not live_: see [Check that a widget is live](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md#check-that-a-widget-is-live).

## Create a review widget

Create a review widget from a template. Cevoid creates it as soon as you click the template, with the template's settings.

1. Navigate to [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets) and click **New widget**
2. Select **Product reviews** or **Company reviews** under _Templates_
3. Optional: Select **Section** or **Element**, or search, to narrow the list
4. Click a template. The new widget opens in the editor, named after its template.

Until you have a widget of their kind, some templates also show on the page as _Suggested_. Click **Add widget** on one to create it. To change the widget, see [Edit a review widget](https://docs.cevoid.com/reviews/showcase/review-widgets#edit-a-review-widget). To add it to your store, see [Embed review widgets](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md).

## Edit a review widget

The review widget editor shows a live preview beside the settings: at desktop, tablet, and mobile sizes for sections, and in one frame for elements.

1. Navigate to [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets) and open the widget
2. Click **Widget** to change how the widget looks. Every setting is in [Review widget settings](https://docs.cevoid.com/reviews/showcase/review-widget-settings.md).
3. Click **Content** to choose which reviews the widget shows, and in what order
4. Optional: Select a language at the top of the editor to preview that market's language
5. Optional: Select **Test data** at the top of the editor to preview sample reviews
6. Click **Save changes**. The widget updates on your store right away.

**Test data** shows sample reviews from a demo store, Void & Oak. The editor opens on it until you have reviews of the widget's type, and on **Real data** after that.

## Choose which reviews a widget shows

A review widget's **Content** tab decides which reviews it shows, depending on its template.

| Widget | Which reviews |
| --- | --- |
| Product page widgets | Every published review of the product on the page. Click **Choose product** to preview one |
| Collection, category, and brand widgets | Every published review of the products in the collection, category, or brand on the page |
| Curated widgets | **All reviews**, or a **Filtered selection** |

Review lists also have a _Default order_: **Latest** (the default), **Oldest**, **Highest rated**, **Lowest rated**, or **Most helpful**. When a shopper picks an order in _Sort by_, theirs replaces yours.

### Pinned reviews

On product page widgets, pinned reviews come first, newest pin first, until a shopper picks an order. Shoppers see a pin icon on them. Pin up to 5 reviews per product from the review's menu: see [Review details](https://docs.cevoid.com/reviews/manage/review-details.md). Pins belong to the product, so **Unpin** in a widget's **Content** tab unpins the review everywhere.

### Filter a curated widget

Filter a curated widget to show only some reviews, such as 4 and 5 stars on the homepage.

1. Navigate to [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets) and open the widget
2. Click **Content**
3. Select **Filtered selection** under _Which reviews_
4. Add filters. The count below them shows how many reviews match.
5. Click **Save changes**

Filter by rating, sentiment, emotions, media, source, verification, reply, language, labels, profile, or creation date. To pick reviews by hand, give them a [review label](https://docs.cevoid.com/reviews/manage/review-labels.md) and filter by it.

A curated widget's rating and summary describe only its selection. A **Company Rating** widget filtered to 4 and 5 stars shows the average of those reviews, not your store's overall average.

## Rename, duplicate, or delete a review widget

Manage a review widget from its menu: right-click its card on [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets), or click **More** in the editor.

| Option | What it does |
| --- | --- |
| **Rename** | Opens _Rename widget_. Enter a name and click **Save changes** |
| **Embed** | Card menu only: opens _Embed widget_. See [Embed review widgets](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md) |
| **Duplicate** | Creates and opens a copy with the same settings and content, named after the original plus _(copy)_. The copy has its own widget ID, so embed it again |
| **Delete** | Deletes the widget after you confirm |

### Delete a review widget

1. Navigate to [Reviews → On-site widgets](https://app.cevoid.com/reviews/on-site-widgets)
2. Right-click the widget's card
3. Select **Delete**
4. Click **Delete widget** to confirm

> [!WARNING]
> Deleting a review widget can't be undone. It stops showing on your store, also where it's still embedded.

## Localization

Review widgets show in the language of the market a shopper visits: Cevoid's own text, the text you enter in a widget's settings, the reviews and your public replies, and dates and numbers. A translated review is marked _Translated from_ its language, with a _Show original_ link. Cevoid translates its own text into Arabic, Danish, Dutch, Finnish, French, German, Irish, Italian, Japanese, Korean, Norwegian, Norwegian Bokmål, Polish, Portuguese, Simplified Chinese, Spanish, Swedish, Traditional Chinese, and Turkish. When a language has no translation for a text, the widget shows it in English.

To check or change translations, navigate to [Settings → Translations](https://app.cevoid.com/settings/translations) and click **Localize** on a language. Widget text is under _Customer-facing texts_, in _On-site widgets (Reviews)_, and review translations are under **Reviews**. See [Translations](https://docs.cevoid.com/localization/translations.md).

## Styling

Review widgets take their fonts, colors, stars, cards, and popups from your [BrandKit](https://docs.cevoid.com/brandkit.md). Each widget picks one of your BrandKit color schemes in _Color scheme_, at the top of the **Widget** tab: see [Color scheme](https://docs.cevoid.com/reviews/showcase/review-widget-settings.md#color-scheme).

## Customer experience

Shoppers see review widgets as part of your page, as their [settings](https://docs.cevoid.com/reviews/showcase/review-widget-settings.md) decide.

### Review cards

Shoppers see each review as a card. Detailed cards add the reviewer's answers and your reply to what simple cards show.

| Part | What shoppers see |
| --- | --- |
| Review | The stars, title, and text. Long text ends in _read more_ |
| Reviewer | Their name and photo, or initials. Reviews without a public name show _Anonymous_ |
| Verification | _Verified buyer_ or _Verified identity_. See [Verified reviews](https://docs.cevoid.com/reviews/collect/verified-reviews.md) |
| Photos and videos | Up to 3 thumbnails, with _+N_ for more |
| Product | On product reviews, the product, linked to its page |
| Disclosures | _Incentivized_ or _Insider_, when your team marked the review so. Widget settings can't hide them |
| Date | When the review was published, and _Updated on_ on hover after an edit |
| Answers | Answers to your review questions, such as the size bought. Detailed cards only |
| Your reply | Your public reply, under _Reply from_ and the sender's name. Detailed cards only |

Words your [moderation settings](https://docs.cevoid.com/reviews/manage/moderation.md) mask show as asterisks. Clicking _read more_ or a thumbnail opens the review in a popup.

### Rating summary and highlights

A review list can open with its rating summary and highlights, in a carousel or a sidebar:

- **Rating summary:** The average, stars, and a bar per star rating. Clicking a bar shows only that rating. When some ratings have no text, it reads, for example, _12 ratings · 9 reviews_.
- **Breakdown:** The answers to your product questions, once a question has 2 answers
- **What people say:** The AI summary, marked _AI-generated summary_, once one exists. See [Reviews AI](https://docs.cevoid.com/reviews/setup/reviews-ai.md).
- **Media:** The newest photos and videos from reviews

### Browse reviews

Shoppers narrow a review list with _Search reviews_, _Sort by_, and _Filter_, which covers stars, _Original language_, _Photos & videos_, _Verified purchases_, and review questions with set answers, such as _Fit_: see [Review list filters](https://docs.cevoid.com/reviews/showcase/review-widget-settings.md#review-list-filters). Review lists load as many reviews at a time as the widget's _Initial items_, 10 by default, with a _See more reviews_ button or as shoppers scroll. Tickers have no search, sort, or filters, and tickers and self-playing carousels show only the first load.

### Popups

The _All reviews_ popup shows all of a widget's reviews, with search, sort, filters, and the highlights. It opens from a star rating set to open a popup, from _See all_ and _Read more_ in a review list's highlights, and from a link: see [Open reviews from a link](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md#open-reviews-from-a-link). A star rating can instead scroll to the review list on the page. On phones, a centered popup opens as a sheet from the bottom, and one set to open from the side fills the screen: see [Popups](https://docs.cevoid.com/brandkit.md#popups).

### Helpful votes and reports

Shoppers vote on whether a review helped, once per device and with no account. To report a review, they click **Report**, pick a reason, and click **Submit report**, and the report reaches your team. Shoppers can't vote on or report their own review. Both are set for all widgets in [Settings → Reviews → Moderation](https://app.cevoid.com/settings/reviews/moderation): see [Moderation](https://docs.cevoid.com/reviews/manage/moderation.md).

### Empty widgets

Until it has enough ratings, a widget stays hidden or shows its empty state, as its settings say. A review list's empty state reads _No reviews yet_, with a **Write a review** button on product page widgets. With ratings but no written reviews, it shows the rating summary and _No written reviews yet_. On a product on your [review blocklist](https://docs.cevoid.com/reviews/manage/review-blocklist.md) with no ratings, product page widgets show nothing.

### Accessibility

Review widgets carry labels for screen readers. For shoppers who turn on reduced motion, tickers stand still and carousels don't play on their own.

## Related articles

- [Review widget settings](https://docs.cevoid.com/reviews/showcase/review-widget-settings.md)
- [Embed review widgets](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md)
- [Review details](https://docs.cevoid.com/reviews/manage/review-details.md)
- [Moderation](https://docs.cevoid.com/reviews/manage/moderation.md)
- [Translations](https://docs.cevoid.com/localization/translations.md)

---

Canonical: https://docs.cevoid.com/reviews/showcase/review-widgets