# Review widget settings

> Every setting of each review widget type, with its options, its default, and what each template changes.

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

Each review widget type has its own settings, in the **Widget** tab of the widget editor. This page lists every setting with its options and default, and what each template changes. To create a widget and choose its reviews, see [Review widgets](https://docs.cevoid.com/reviews/showcase/review-widgets.md).

| Widget type | Settings groups | Templates |
| --- | --- | --- |
| Review list | **Section**, **Header**, **Filters**, **Items**, **Load more**, **Visibility** | **Dynamic Product Reviews**, **Dynamic Collection Product Reviews**, **Dynamic Category Product Reviews**, **Dynamic Brand Product Reviews**, **Product Review Highlights Carousel**, **Product Reviews Ticker Wall**, **All Company Reviews**, **Company Review Highlights Carousel**, **Company Reviews Ticker Wall** |
| Star rating | **Rating**, **Visibility** | **Dynamic Product Rating**, **Company Rating** |
| Rating summary | **Style**, **Header**, **Rating**, **Visibility** | **Dynamic Product Rating Summary**, **Company Rating Summary** |
| AI summary | **Style**, **Header** | **Dynamic Product AI Summary**, **Product AI Summary of Selected Reviews**, **Company AI Summary** |
| Question summary | **Style**, **Header**, **Questions**, **Visibility** | **Dynamic Product Question Summary** |

The defaults below are where a setting starts unless the widget's template changes it. Each widget type ends with what its templates change.

## Settings on every widget

Every review widget has a color scheme, some settings can differ per device, and a header's title and description can name the page's product, collection, category, or brand.

### Color scheme

_Color scheme_ sits at the top of the **Widget** tab, above the settings groups, once your workspace has a [BrandKit](https://docs.cevoid.com/brandkit.md). It sets the colors of the whole widget, its section band included, from one of your BrandKit's [color schemes](https://docs.cevoid.com/brandkit.md#color-schemes). A widget starts on your default scheme, and the collection, category, and brand templates start on the secondary scheme. **Edit scheme** opens the scheme in BrandKit, and **Change** picks another.

### Settings per device

_Layout_, _Initial items_, _Padding_, and _Title size_ can have a different value on tablet and mobile. Click **+** next to the setting's name and select **Tablet** or **Mobile**. To go back to the desktop value, remove the override.

A widget picks its device settings by its own width on the page, not by the screen: up to 640 px wide it uses its mobile settings, up to 1,024 px its tablet settings, and above that its desktop settings. A widget in a narrow column uses its mobile settings on a desktop screen.

Options that don't fit the rest of the settings are greyed out with the reason, such as _Only for the carousel layout_. When you save, Cevoid adjusts settings that no longer fit together: a **Left header** arrangement without a carousel becomes **Stacked**, and a load-more **Button** on a carousel becomes **Infinite**.

### Variables in titles and descriptions

A header's _Title_ and _Description_ can hold variables, which each page fills in. Click the variables icon next to the field to see the _Available variables_ for the widget, and click one to copy it.

| Variable | Shows | Available on |
| --- | --- | --- |
| `{{productName}}` | The product's name | Product page widgets |
| `{{collectionName}}` | The collection's name | Collection widgets |
| `{{categoryName}}` | The category's name | Category widgets |
| `{{brandName}}` | The brand's name | Brand widgets |
| `{{ratingValue}}` | The average rating, with one decimal, in the market's number format | Every widget with a header |

Names come from the shopper's market, such as the Swedish product title on a Swedish storefront. A variable with no value on a page, such as `{{ratingValue}}` before the first rating, is left out on your store, so shoppers never see it. When a field holds a variable the widget can't fill, a note under the field says _Left out on this widget_.

## Review lists

A review list shows review cards in a band of its own, with an optional heading, rating summary, highlights, and controls for shoppers. It loads as many reviews at a time as its _Initial items_, 10 by default.

### Review list section

The section is the band the review list sits in. The band takes its colors from the widget's color scheme.

| Setting | Options | Default |
| --- | --- | --- |
| _Section_ | On or off. Off shows the widget bare, with no band, max width, or padding | On |
| _Width_ | **Fixed** or **Full** | **Fixed** |
| _Max width_ | 320 to 2,400 px, with _Width_ on **Fixed** | 1,200 px |
| _Padding_ | Vertical and horizontal, 0 to 200 px each. Can differ per device | 60 px vertical, 30 px horizontal |

### Review list header

The header holds the review list's title, and decides where it sits.

| Setting | Options | Default |
| --- | --- | --- |
| _Arrangement_ | **Stacked**, with the header above the reviews, or **Left header**, beside them. **Left header** needs the **Carousel** layout and the title on | **Stacked** |
| _Section title_ | On or off | On |
| _Title_ | Your text | None |
| _Title size_ | **XS**, **S**, **M**, **L**, or **XL**. Can differ per device | **L**, and **M** on mobile |
| _Description_ | Your text, under the title | None |
| _Alignment_ | **Left** or **Center** | **Left** |
| _Header action_ | **None**, **Write a review**, or **Carousel navigation**, beside a left-aligned title. **Write a review** needs a product page widget. **Carousel navigation** needs the **Carousel** layout with no filters and no summaries | **None** |

### Review list summaries

The summaries are the rating summary and highlights above the reviews, set under _Summaries_ in the **Header** group. They need the **Stacked** arrangement.

| Setting | Options | Default |
| --- | --- | --- |
| _Layout_ | **None**, **Carousel**, or **Sidebar**. **Sidebar** isn't available with the **Carousel** layout | **Carousel** |
| _Style_ | **Card** or **Plain**, with _Layout_ on **Carousel** | **Card** |
| _Order_ | _Rating summary_ first, then _Question breakdown_, _AI summary_, and _Media_, each with its own switch. Drag the last three to reorder them | All on |
| _Rating layout_ | **Stacked** or **Beside**: the average above or beside the bars | **Stacked** |
| _Rating counts_ | On or off. Shows the number of reviews at the end of each bar | Off |

A carousel shows 2 summaries side by side from 720 px of widget width. A sidebar needs 880 px, and shows as a carousel in a narrower widget.

### Review list filters

The filters are the controls shoppers use to search, sort, and filter the reviews. None of them are available with the **Left header** arrangement, or when the header holds the carousel navigation. Search, sort, and filters aren't available with the **Ticker** layout either.

| Setting | Options | Default |
| --- | --- | --- |
| _Search_ | On or off | On |
| _Search width_ | **Compact** or **Full width** | **Compact** |
| _Sort_ | On or off | On |
| _Filters_ | On or off. _Options_ picks the filters shoppers get: _Rating_, _Media_, _Verified_, _Language_, and _Questions_ | On, with all 5 options |
| _Action_ | **None** or **Write review**, at the end of the row. **Write review** needs a product page widget | **None** |

Shoppers see the options as the stars, _Photos & videos_, _Verified purchases_, _Original language_, and one section for each review question they can filter by. _Original language_ only shows when the reviews are in more than one language. The order the list starts in is the widget's _Default order_, in the **Content** tab.

With _Questions_ on, a public review question becomes a filter when shoppers pick from set answers: _Single select_, _Multi select_, _Would recommend_, and _Centered range_ questions with a label on every step, such as the _Fit_ template. _Scale_ questions, which label only their ends, and _Numeric_ questions can't be filtered. Each filter only offers the answers given in the widget's own reviews. Answers to one question widen the results, and answers to different questions narrow them, up to 20 answers at once.

### Review list layout

_Layout_ sets how the review cards are arranged: **Grid**, **Masonry**, **Carousel**, **Ticker**, or **List**. It can differ per device, and starts on **Grid**. Each layout's settings open from the settings button next to it, such as _Carousel settings_.

_Initial items_, under _Layout_, sets how many reviews the first load shows, and how many each load after it adds: 1 to 100, 10 by default. It can differ per device, so a grid can end on a full row on every screen.

**Grid and Masonry:**

| Setting | Options | Default |
| --- | --- | --- |
| _Min width_ | 200 to 1,200 px per card. As many columns as fit | 300 px |
| _Gap_ | 0 to 80 px | 16 px |

**Carousel:**

| Setting | Options | Default |
| --- | --- | --- |
| _Slides per view_ | **Auto**, or **Fixed** with _Visible slides_, 0.5 to 12 | **Auto** |
| _Gap_ | 0 to 80 px | 16 px |
| _Overflow_ | **Hide**, **Fade**, or **Visible**: how the next slides show at the edge | **Hide** |
| _Align_ | **Start**, **Center**, or **End** | **Start** |
| _Slides to scroll_ | **Adaptive** (1 slide, or 2 in a carousel 768 px wide or more), **Full view**, or **Fixed** with _Slides per step_, 1 to 12 | **Adaptive** |
| _Motion_ | **Off**, or **Autoplay** with an _Interval_ of 500 to 60,000 ms | **Off**, with a 3,500 ms interval |
| _Arrows_ | On or off | On |
| _Arrow position_ | **Left**, **Center**, or **Right** below the slides, **Over the items**, or **Header action** | **Right** |
| _Progress_ | **None**, **Dots**, **Scrollbar**, or **Progress bar** | **Dots** |
| _Dots position_ | **Left**, **Center**, or **Right** | **Center** |

**Ticker:**

| Setting | Options | Default |
| --- | --- | --- |
| _Speed_ | 10 to 100%, with 100% the fastest | 100% |
| _Hover_ | 0 to 100% of the running speed while a shopper hovers. 0% pauses the ticker | 100% |
| _Direction_ | **Left**, **Right**, **Up**, or **Down** | **Left** |
| _Lanes_ | 1 to 4 | 1 |
| _Alternate_ | On or off. Every other lane runs the opposite way. With more than one lane | On |
| _Fade edges_ | On or off | Off |
| _Container height_ | 200 to 2,000 px, for **Up** and **Down** | 600 px |
| _Item width_ | 200 to 1,200 px, for **Left** and **Right** | 320 px |
| _Gap_ | 0 to 80 px | 16 px |

**List:**

| Setting | Options | Default |
| --- | --- | --- |
| _Gap_ | 0 to 80 px | 16 px |
| _Separators_ | On or off. Lines between the reviews | Off |

A ticker, and a carousel that plays on its own, show only the first load, as many reviews as _Initial items_. Search, sort, and filters aren't available on a ticker. For shoppers who turn on reduced motion, tickers stand still and carousels don't play on their own.

### Review cards

The card settings, under **Items**, decide what each review card shows.

| Setting | Options | Default |
| --- | --- | --- |
| _Style_ | **Simple** or **Detailed**. Detailed cards add the reviewer's answers to your review questions and your public reply | **Simple** |
| _Card_ | **Elevated**, with a background, border, and shadow, or **Flat**, on the page's own background | **Elevated** |
| _Max text lines_ | 1 to 20 lines of text before _read more_ | 6 |
| _Fields_ | A switch for each part of the card: _Avatar_, _Media_, _Verified badge_, _Date_, _Product_ (product reviews only), _Helpful votes_, and _Report button_. Detailed cards add _Question answers_, _Recommendation_, and _Your reply_ | All on |

_Helpful votes_ and _Report button_ can only hide what your [moderation settings](https://docs.cevoid.com/reviews/manage/moderation.md) turn on. When votes or reports are off there, the switch is locked, with _Helpful votes are off in Reviews settings_ or _Review reports are off in Reviews settings_. No setting hides the _Incentivized_ and _Insider_ disclosures.

### Load more

**Load more** decides how shoppers get past the first load of reviews.

| Setting | Options | Default |
| --- | --- | --- |
| _Load more_ | **None**, **Button**, or **Infinite**, which loads more as shoppers scroll, or as they reach a carousel's last slide | **Button** |
| _Button style_ | **Primary**, **Secondary**, or **Ghost**, with **Button** | **Secondary** |
| _Button label_ | Your text, with **Button** | _See more reviews_ |

**Button** isn't available on a carousel. Tickers and carousels that play on their own don't load more, so they don't show this group.

### Review list visibility

**Visibility** decides what a review list shows until it has enough ratings. The count includes star-only ratings, across all the widget's reviews before shoppers filter them.

| Setting | Options | Default |
| --- | --- | --- |
| _When empty_ | **Empty state** or **Hidden** | **Empty state** |
| _Title_ | With **Empty state**: your text | _No reviews yet_ |
| _Description_ | With **Empty state**: your text. Clear it to show no description | _Be the first to share your experience_ |
| _Write review button_ | With **Empty state**: on or off. Only shows when the widget has no other write review button. Opens the product review form on product page widgets | On |
| _Hidden until_ | With **Hidden**: 1, 2, 3, 5, 10, 25, or 50 ratings | 1 rating |

### Review list templates

Each review list template changes some of the defaults above.

| Template | Changes from the defaults |
| --- | --- |
| **Dynamic Product Reviews** | Title _Customer reviews_. **List** layout. **Detailed** cards with 10 text lines |
| **Dynamic Collection Product Reviews**, **Dynamic Category Product Reviews**, **Dynamic Brand Product Reviews** | Secondary color scheme. Title _Customer reviews_. Summaries **None**, without _Question breakdown_. No search, sort, or filters. **Carousel** layout with _Overflow_ **Visible** and the arrows as the header action. No helpful votes or report button. _Load more_ **Infinite**. Hidden until 1 rating |
| **Product Review Highlights Carousel**, **Company Review Highlights Carousel** | Title _What our customers say_, centered. Summaries **None**. No search, sort, filters, or load more. No date, helpful votes, or report button. **Carousel** layout with _Overflow_ **Fade**, _Motion_ **Autoplay**, no arrows, and dots. Hidden until 3 ratings. Starts with 4 and 5 star reviews |
| **Product Reviews Ticker Wall**, **Company Reviews Ticker Wall** | Title _Loved by our customers_, centered. Summaries **None**. No load more. No media, date, helpful votes, or report button. **Ticker** layout running up in 3 lanes with faded edges, 800 px tall, in 2 lanes on tablet and 1 lane running left on mobile. Hidden until 5 ratings. Starts with 4 and 5 star reviews |
| **All Company Reviews** | Title _Customer reviews_. _Load more_ **Infinite** |

On company templates, _Product_ is off, since company reviews have no product.

## Star ratings

A star rating shows stars, the average rating, and the number of ratings, for a product or for your store. The number of ratings includes star-only ratings.

### Star rating options

The **Rating** group decides what the star rating shows and what clicking it does.

| Setting | Options | Default |
| --- | --- | --- |
| _Average_ | On or off, with _After the average_: text after the number | On, with no text, so it reads _4.8_ |
| _Review count_ | On or off, with _After the count_: text after the number | On, with no text, so it reads _(128)_ |
| _Size_ | 10 to 32 px. **Use brand default** returns to the size your BrandKit sets | The size your BrandKit sets |
| _On click_ | **Scroll**, to the first review list on the page, **Popup**, which opens _All reviews_, or **Nothing** | **Scroll** |
| _Scroll offset_ | -500 to 500 px, with **Scroll**. A negative offset stops above the reviews, to clear a fixed header | 0 px |

With **Scroll**, nothing happens on a page without a review list.

### Star rating visibility

**Visibility** decides what a star rating shows until it has enough ratings.

| Setting | Options | Default |
| --- | --- | --- |
| _When empty_ | **Empty state** or **Hidden** | **Empty state** |
| _Empty state_ | **Default**, the stars with _(0)_, or **Review prompt** | **Default** |
| _Prompt text_ | With **Review prompt**: the text shoppers click. On a product rating, it opens the product review form | _Write the first review_ |
| _Hidden until_ | With **Hidden**: 1, 2, 3, 5, 10, 25, or 50 ratings | 1 rating |

### Star rating templates

| Template | Changes from the defaults |
| --- | --- |
| **Dynamic Product Rating** | Hidden until 1 rating |
| **Company Rating** | _On click_ **Popup**. Hidden until 1 rating |

## Rating summaries

A rating summary shows the average rating, stars, and a bar for each star rating, for a product or for your store, without a review list. Its count, such as _128 reviews_, counts every rating, star-only ratings included.

### Rating summary style

| Setting | Options | Default |
| --- | --- | --- |
| _Display_ | **Plain**, on the page, or **Card**, framed in your BrandKit card | **Plain** |

### Rating summary header

| Setting | Options | Default |
| --- | --- | --- |
| _Title_ | On or off, and your text | On, with no text |
| _Title size_ | **XS**, **S**, **M**, **L**, or **XL**. Can differ per device | **M** |
| _Description_ | Your text, under the title | None |
| _Alignment_ | **Left** or **Center** | **Left** |

### Rating summary options

| Setting | Options | Default |
| --- | --- | --- |
| _Rating layout_ | **Stacked** or **Beside**: the average above or beside the bars | **Stacked** |
| _Rating counts_ | On or off. Shows the number of reviews at the end of each bar | Off |

Shoppers can't click the bars of a rating summary.

### Rating summary visibility

| Setting | Options | Default |
| --- | --- | --- |
| _When empty_ | **Empty state** or **Hidden** | **Empty state** |
| _Title_ | With **Empty state**: your text | _No reviews yet_ |
| _Hidden until_ | With **Hidden**: 1, 2, 3, 5, 10, 25, or 50 ratings | 1 rating |

### Rating summary templates

| Template | Changes from the defaults |
| --- | --- |
| **Dynamic Product Rating Summary**, **Company Rating Summary** | _Title_ off. _Display_ **Card**. _Rating layout_ **Beside**, with _Rating counts_ on. Hidden until 1 rating |

## AI summaries

An AI summary shows the AI-written paragraph about what reviewers say, with _AI-generated summary_ under it, which no setting removes. It has no **Visibility** group: the widget shows nothing until a summary exists. A summary needs 30 published reviews with text, and is updated at most once every 7 days: see [Reviews AI](https://docs.cevoid.com/reviews/setup/reviews-ai.md). The editor previews a sample paragraph until then.

### AI summary style

| Setting | Options | Default |
| --- | --- | --- |
| _Display_ | **Plain**, on the page, or **Card**, framed in your BrandKit card | **Plain** |

### AI summary header

| Setting | Options | Default |
| --- | --- | --- |
| _Title_ | On or off, and your text | On, with the template's title |
| _Title size_ | **XS**, **S**, **M**, **L**, or **XL**. Can differ per device | **M** |
| _Description_ | Your text, under the title | None |
| _Alignment_ | **Left** or **Center** | **Left** |

### AI summary templates

| Template | Changes from the defaults |
| --- | --- |
| **Dynamic Product AI Summary** | Title _What our customers say_ |
| **Product AI Summary of Selected Reviews** | Title _Highlights from these reviews_ |
| **Company AI Summary** | Title _What customers say about us_ |

## Question summaries

A question summary shows, for the product on the page, a summary of the answers reviewers gave to your product questions, such as fit or softness. A question shows once it has 2 answers, and only public questions show. It sums up all the product's reviews. See [Review questions](https://docs.cevoid.com/reviews/collect/review-questions.md).

### Question summary style

| Setting | Options | Default |
| --- | --- | --- |
| _Display_ | **Plain**, on the page, or **Card**, framed in your BrandKit card | **Plain** |

### Question summary header

| Setting | Options | Default |
| --- | --- | --- |
| _Title_ | On or off, and your text | On, with no text |
| _Title size_ | **XS**, **S**, **M**, **L**, or **XL**. Can differ per device | **M** |
| _Description_ | Your text, under the title | None |
| _Alignment_ | **Left** or **Center** | **Left** |

### Question summary questions

| Setting | Options | Default |
| --- | --- | --- |
| _Questions_ | 1 to 10: how many questions to show. Each product shows its own questions, in the order they're set up | 3 |

### Question summary visibility

| Setting | Options | Default |
| --- | --- | --- |
| _When empty_ | **Empty state** or **Hidden**. **Hidden** hides the widget while no question has answers to show | **Empty state** |
| _Title_ | With **Empty state**: your text | _No answers yet_ |

### Question summary template

| Template | Changes from the defaults |
| --- | --- |
| **Dynamic Product Question Summary** | _Title_ off. _When empty_ **Hidden** |

## Related articles

- [Review widgets](https://docs.cevoid.com/reviews/showcase/review-widgets.md)
- [Embed review widgets](https://docs.cevoid.com/reviews/showcase/embed-review-widgets.md)
- [Moderation](https://docs.cevoid.com/reviews/manage/moderation.md)
- [Review questions](https://docs.cevoid.com/reviews/collect/review-questions.md)

---

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