Skip to content

Review Summary ​

Show your overall rating, how many reviews it's based on and a star-by-star breakdown, with an optional AI-written summary of what customers are saying.

Review Summary with the average rating and a star-by-star breakdown above testimonials

The Review Summary block sits at the top of a testimonials section and gives visitors a reason to trust what follows. Instead of making them read every review to size you up, it shows the whole picture first: your average star rating, how many reviews it's based on, and a breakdown of how many people left 5 stars, 4 stars, and so on. It can also add a "Write a Review" button and an AI-generated summary paragraph.

It reads from the same testimonials as the display block it sits above, so the numbers always match what's on the page.

How to add it ​

Review Summary is a child block: a block that lives inside another block rather than one you add on its own. So you don't insert it directly. Instead, turn on Review Summary in a display block's Layouts panel, and the plugin tucks the summary in above your testimonials, reading from the same set of reviews. (Behind the scenes it wraps everything in a Testimonial Group for you.)

What it counts ​

The numbers come from your own testimonials (the ones managed in WordPress), filtered by whatever the parent group is showing: latest, a group, specific picks or a star-rating filter. Two things to keep in mind:

  • Only testimonials that have a star rating (1–5) are counted. Unrated ones are ignored, so the "based on N reviews" total can be lower than your total testimonial count.
  • It only summarizes testimonials managed in WordPress. It doesn't pull in ratings from anywhere else.

Settings ​

The inspector (the settings sidebar on the right) has three panels: Review Summary, AI Summary and Advanced Settings. The first two each have a Settings tab for what shows and a Style tab for how it looks.

Sample numbers in the editor

Until the block finds testimonials with a star rating, the editor shows sample figures (a 4.8 average from "11k" reviews) so you have something to style. Your live page always shows the real numbers.

Review Summary ​

Review Summary panel — Settings tab

On the Settings tab:

ControlWhat it does
Select Display StyleTwo layouts: Template One (a large average number with stars beside it) or Template Two (a more compact inline rating). Switching templates also flips two other settings for you: Template One turns Overall Label off and sets Breakdown Style to One; Template Two turns the label on and sets the style to Two. You can still change either afterward.
Overall LabelShow a word for the rating, like Excellent. Off by default. Once it's on, the Label dropdown offers Auto (Based on Rating), chosen from the average (4.5 and up is Excellent, 3.5 Good, 2.5 Average, 1.5 Poor, anything lower Bad), or Custom, which adds a Custom Label field (default Excellent).
Show Rating BreakdownShow the per-star bars (5 down to 1) with a percentage for each. On by default.
Breakdown StyleTwo visual styles for those bars: One or Two.
Show Review CountAdd the number of reviews to each breakdown row. On by default.
Hide on MobileHide just the breakdown bars on phones to save space. On by default. (To hide the whole block on a device, use Advanced Settings instead.)
Review ButtonShow a call-to-action button. On by default.
Button ActionWhat the button does: Open Popup Form (opens a submission form in a popup, the default), Scroll to Form (jumps to a form elsewhere on the page) or Open Custom URL (adds a Custom URL field for the link).
Button LabelThe button text. Default Write a Review.
DividerA dividing line between the overall rating and the breakdown. On by default.
Text Alignment / Justify Content / Horizontal GapFine-tune how the pieces line up and how much space sits between them. The gap is 24 px on desktop, 16 px on tablet and 12 px on mobile by default.

The Style tab works from top to bottom:

  • Primary Typography and Primary Color for the big average number and the overall label.
  • Secondary Typography and Secondary Color for "Out of 5" and the review count.
  • Fill Star Color and Empty Star Color.
  • Breakdown Typography and Color for the breakdown text, plus a Bar Style popover with Bar Fill Color, Bar Background Color and Bar Thickness (default 8 px). These only appear while the breakdown is on.
  • Button Typography and a Button Style popover (color, background, border, radius, padding, shadow and margin), shown while the button is on.
  • A Divider Style popover (line style, Thickness, Height as a percentage of the row, default 80%, and Divider Color), shown while the divider is on.
  • The block's own box: Background Type, border, Border Radius, Box Shadow, Padding and Margin (24 px below by default).

Review Summary panel — Style tab

How the "Write a Review" popup gets its form

When Button Action is Open Popup Form, the block adds a Submission Form inside itself for you. In the editor it sits under the note Popup form — shown when the button is clicked on the frontend. Select it to set up its fields like any submission form. Because the Review Summary provides the popup, the form's own Form Display Type, Popup Settings and Motion Effects panels are hidden there. Scroll to Form and Open Custom URL don't use a nested form.

AI Summary ​

Turn on AI Summary to add a short, automatically written paragraph (or list) that sums up what your reviewers are saying.

AI Summary panel — Settings tab

The text is written by an AI service: Google Gemini, OpenAI, Anthropic Claude or Groq. You need at least one connected first, under Settings → AI Configuration. When the toggle is on, the panel shows a reminder with a link to that tab. Until a provider is connected, the summary doesn't appear on your live site. If you've only just added a key, reload the editor so the panel can see it.

On the Settings tab:

ControlWhat it does
AI ProviderWhich connected service writes this block's summary. Only connected providers are listed. If you don't pick one, the block uses your Primary provider, which is the one the list shows.
AI ModelWhich of that provider's models to use. The recommended one is marked (Recommended) and is what runs until you pick something else. Picking a model also locks in the provider above it, and changing the provider resets the model.
AI Summary StyleText (paragraphs) or List (bullet points).
AI Summary LengthFull, or Limited (the default), which cuts the summary to a word count. Limited adds Length (10 to 500 words, default 60), Ellipsis Points (default ...) and a Read More toggle (on by default) with an editable Read More Label. Turn Read More off and the summary just stays cut short.
Text Typing AnimationPlays a typing effect as the summary appears. On by default.
Animated AI IconAnimates the small AI icon next to the heading. On by default.

The section heading (AI-Generated Summary, with "Based on N Reviews, Created with AI" beneath it) is fixed. There's no field to change it.

The Style tab has typography and color for the Title, Label and Summary text, plus the box's Background Type, border, Border Radius, Box Shadow, Padding and Margin.

AI Summary panel — Style tab

If your provider fails, a backup steps in

With more than one provider connected, a failed request (a used-up quota, a rejected key, an outage) is passed to the next connected provider automatically, and it uses its own recommended or saved model. Visitors never notice. See Primary provider and failover.

AI summaries are cached

Once written, a summary is saved for 12 hours so the block doesn't have to regenerate it on every page load. It's also rewritten whenever you change the provider, the model, the Display Limit or which testimonials the block shows. So if you widen the block from 10 reviews to 50, you get a summary of the 50, not a stale one of the 10. Turn the feature on only once you have enough reviews for the summary to be meaningful.

If a summary can't be generated, only you see the problem

When the AI service fails (a missing or rejected key, a provider outage, no provider connected, or no reviews with any text to summarize), the block shows AI summary unavailable with a short explanation, plus the note Only administrators can see this message. Visitors see nothing at all in that spot rather than an error or a half-written summary. The same warning appears in the editor.

A few more things worth knowing:

  • What gets sent: the star rating and text of each testimonial the block shows (up to 200). Reviewer names and photos aren't sent, and the summary never quotes or names individual reviewers.
  • The summary is written in English, whatever language your reviews are in.
  • Each new summary is billed by your AI provider under its own pricing. Caching keeps that to roughly one request per summary every 12 hours.

Advanced Settings ​

This panel has two tabs:

  • Visibility: Hide on Desktop, Hide on Tablet and Hide on Mobile hide the whole Review Summary on that kind of screen.
  • Advanced: Custom CSS Class adds your own class name to the block, so you can target it from your theme's custom CSS. Unlike the display blocks, the Review Summary has no Custom CSS ID field.

The block's background, border and spacing live on the Review Summary panel's Style tab (see above), not here.

Tips ​

  • Place the Review Summary above a Grid or Bento Grid for a classic "reviews" header.
  • The breakdown bars are a trust signal in their own right. Keep them visible even when most reviews are 5-star; a chart that leans heavily toward 5 still reads as authentic.
  • Leave Button Action on Open Popup Form so visitors can add their own review without leaving the page. The Submission Form comes built in.
  • Connect a second AI provider in AI Configuration if your AI summary matters to you. It acts as an automatic backup.