Skip to content

Blocks Overview ​

Every Real Testimonials block in one place, with what each one does and how to pick the right one for your page.

Real Testimonials ships as a library of blocks: the reusable content pieces you add to a page in the WordPress editor. You'll find them in the block inserter (the panel that opens when you click the + button while editing a page or post), under two categories:

  • Real Testimonials holds almost everything: the layouts, the badge and the two blocks that collect testimonials.
  • Real Testimonials (Classic) holds the two shortcode bridge blocks, which place things you built the classic way.

The library splits into two groups, the same two you'll see in this site's sidebar:

  • Display Blocks put testimonials on the page: eleven layouts, a trust badge, two blocks that collect testimonials from visitors, and two shortcode bridge blocks (a shortcode is a small [bracketed] code that places saved content).
  • Child Blocks add filtering, search and pagination on top of a layout.

If this is your first showcase, start with a layout block. That's what actually puts testimonials on the page. Everything else is optional, and you can add it later.

How to add a block ​

You add every Real Testimonials block the same way:

  1. Open the page or post you want to edit.
  2. Click the + button to open the inserter, then search for the block by name (for example, Grid) or scroll to the Real Testimonials category.

Real Testimonials block library

  1. Click the block to drop it onto the page. Most display blocks first show a small picker on the page itself. Depending on the block, it asks you to Choose Your Card Design, Select Layout, or (on the Review Badge) Select Display Style. Click one of the icons and the block fills in with your published testimonials, so you see a live preview as you work. A few blocks skip the picker and fill in straight away: Bento Grid, Submission Form and Record Video.

    Under the icons you'll find two shortcuts:

    • Start with Ready Patterns opens the pattern library on that block's patterns. Pick one and it replaces the placeholder with a finished, styled design. See Start from a Ready Pattern below.
    • Build with AI lets you describe the block you want in plain words and have it set up for you. See Build it with AI below.

    You don't have to decide straight away. The inspector (the settings panel on the right) is already usable while the picker is showing.

Card design picker with Start with Ready Patterns and Build with AI buttons

  1. Adjust its settings in the inspector, then Publish or Update the page.

At the top of a block's inspector you'll also find a Documentation button, which opens that block's page on this site in a new tab. Blocks that have patterns get a Ready Patterns button next to it, which opens the pattern library on that block's designs.

Start from a Ready Pattern ​

A pattern is a finished testimonial section, already styled, that you drop onto the page and then adjust. There are 225+ of them, and every display block except the two shortcode blocks has its own set. You can open the library four ways:

  • Patterns Library in the editor's top toolbar. The library opens on all patterns.
  • Start with Ready Patterns on a block's first-insert picker. The pattern replaces the placeholder block.
  • Ready Patterns at the top of a block's inspector. The pattern is added as a new block, and the block you're editing stays as it is.
  • Use a Pattern on the dashboard's home screen. It opens a new page with the library already open.

Inside the library, the sidebar on the left filters by Block Type and Category Type. When you come from a block, its block type is picked for you, but you can switch to All Patterns or another block at any time. Click a pattern to preview it at desktop, tablet or mobile width, use Prev and Next to flip through the others, and click Insert when you find the one you want.

The patterns bring the design, not the content: your own published testimonials fill them in. The library is a module you can switch off; see Ready Patterns Library.

Build it with AI ​

Not sure which block or settings you want? Describe it instead. With the Build with AI module on and an AI provider connected under Settings → AI Configuration, you get four ways in:

  • Build with AI in the editor's top toolbar, next to Patterns Library. It builds a brand-new block from a sentence like "A testimonial slider with customer photos, star ratings and short quotes."
  • Build with AI on a block's first-insert picker. It sets up the block you just dropped in.
  • Refine with AI on the floating toolbar of a block that's already set up. It changes only what you ask for, such as "Make the cards dark with light text and show 4 per row."
  • Build with AI on the dashboard's home screen. It opens a new page with the AI window already open.

The AI only chooses the layout and design settings. The testimonials themselves always come from your site. The Build with AI section covers everything it can and can't change, and what happens if your AI provider hits its limit.

Display Blocks — put testimonials on the page ​

These are the blocks you'll reach for most. At the core are eleven layout blocks. Each one pulls in your published testimonials and arranges them on the page, and what really sets them apart is the look and each block's own Layouts panel. Almost everything else (the card designs, the Query Builder that decides which testimonials show, and the color, typography and spacing controls) is shared, so you can switch layouts later without redoing your work. Those shared panels are explained once, in full, on the Carousel page.

The rest of the group works a little differently. The Review Badge sums up your reviews in a single trust mark instead of listing them. The Submission Form and Record Video collect testimonials rather than display them. And the two shortcode bridge blocks, Real Testimonials Shortcode and Classic Form Shortcode, live under the Real Testimonials (Classic) category. Each of these has its own settings instead of the shared panels.

BlockBest for
CarouselA rotating carousel with arrows and dots. It comes in Standard, Center and Coverflow styles, with slide, fade, cube and flip effects.
MarqueeA ticker that scrolls nonstop, horizontally or vertically, with adjustable speed and direction.
SliderShows one testimonial at a time as a smooth, full-width slider.
GridAn even, responsive wall of testimonials in neat columns.
Bento GridModern, mixed-size cards arranged in a stylish bento grid.
Polaroid GridA playful, Polaroid-style photo grid. Great when your testimonials have reviewer photos.
MasonryA Pinterest-style layout that adapts to testimonials of different lengths, with no awkward gaps.
ListOne testimonial per row with the photo beside the text, optionally alternating sides. Best for long, story-style reviews.
Stacked CardsA deck of cards: either one at a time with the rest peeking out behind, or the whole set fanned out like a hand.
SpotlightOne review on the stage at a time, with the rest as a list of names, a strip of photos, or a grid of faces to click.
Video TestimonialsShows the video clips you've collected, in a carousel or a grid, playing in a popup or inline.
Review BadgeA single trust badge showing your overall rating, stars and review count. Place it inline with your content or float it in a page corner.
Submission FormA customizable front-end form where visitors submit their own text, photo or video testimonials, with a star rating, configurable fields and reCAPTCHA spam protection. New submissions arrive as pending for your approval.
Record VideoLets visitors record a video testimonial with their webcam, or upload one, and send it straight to your site for approval.
Real Testimonials ShortcodePlaces a saved classic View (a testimonial layout built in the admin area) on a page. You pick it from a dropdown, so there's no shortcode to copy.
Classic Form ShortcodeEmbeds a submission form built the classic way, chosen from a dropdown.

Choosing a layout ​

Not sure which one to use? Start from what you need:

  • Limited vertical space, lots of reviews? Carousel rotates through them in one band.
  • A lively "wall of love"? Marquee scrolls continuously, no interaction needed.
  • One standout quote in a hero? Slider features a single testimonial at a time.
  • Just want it to look good everywhere? Grid is the safe all-purpose choice.
  • Design-forward landing page? Bento Grid mixes card sizes for a magazine feel.
  • Strong reviewer photos? Polaroid Grid frames each one like an instant print.
  • Reviews vary a lot in length? Masonry lets every card take just the height it needs.
  • Long, story-style reviews? List gives each one a full row to itself.
  • Want one review read properly, not skimmed? Spotlight puts a single review on the stage and turns the rest into a way to browse.
  • Need it to feel less corporate? Stacked Cards shows reviews as a deck you flick through, or a fanned hand of cards.
  • Collected video clips? Video Testimonials plays them in a carousel or grid.
  • Just need a credibility mark next to a button? Review Badge is one small badge, not a section.

Whichever you pick, read the Carousel page once. It explains every shared inspector panel in detail, and after that you'll already know how most of the layouts work. The other block pages only cover what's unique to them and link back to it.

Child Blocks — filtering, search & pagination ​

Want visitors to filter, search, or page through your testimonials? That's the job of the child blocks. A child block can't stand on its own. It lives inside a Testimonial Group, a container that wraps a layout block and adds controls around it.

One term to know here: Ajax means the page updates part of itself instantly, without a full reload. Every block below that says "no reload" is doing exactly that.

BlockWhat it does
Testimonial GroupThe container that holds a layout block plus its filtering, search and pagination controls. It's added for you automatically, so you won't find it in the inserter on its own.
Live Frontend FilterLets visitors filter testimonials live on the front end. It wraps the two filter blocks below and can combine them with AND or OR logic.
Filter by GroupFilters testimonials by group (their category), shown as a dropdown or a button group.
Filter by RatingFilters testimonials by star rating, shown as a dropdown or a button group.
Ajax Testimonial SearchA search box that narrows the testimonials as visitors type, with no page reload.
Review SummaryShows the overall rating, total number of reviews and a quick summary of the feedback. You can write it yourself or have AI generate it.
Ajax PaginationBreaks a long list into pages, with either a load-more button or numbered pages. Neither reloads the page.

You rarely add these by hand. When you switch on Live Frontend Filter, Ajax Testimonial Search, Review Summary, or Ajax Pagination from a layout block's Layouts panel, Real Testimonials automatically tucks your block inside a Testimonial Group and drops the matching child block into place.

Each layout offers the add-ons that make sense for it:

  • Grid, Bento Grid, Polaroid Grid, Masonry and List offer all four.
  • Carousel and Marquee offer everything except Ajax Pagination.
  • Stacked Cards offers the summary, filter and search on both layouts, plus Ajax Pagination on the fanned deck.
  • Spotlight offers the summary, filter and search on its Minimal and Carousel layouts, and none on the photo Grid.
  • Video Testimonials offers search on both layouts, plus Ajax Pagination on the Grid.
  • Slider offers only Review Summary.
  • Review Badge, which is a single badge, has none.

If you're curious how they nest:

Testimonial Group
├─ Review Summary
├─ Live Frontend Filter
│  ├─ Filter by Group
│  └─ Filter by Rating
├─ Ajax Testimonial Search
├─ Main block (Grid, Carousel, …)
└─ Ajax Pagination

Turning blocks on and off ​

Seeing blocks you know you'll never use? Enable or disable any of them from the Dashboard → Blocks page to keep your inserter uncluttered. A disabled block is off everywhere: it disappears from the inserter and stops showing on any page that already uses it, so visitors won't see it. Nothing is deleted, though. The block stays in your page content, so turning it back on restores it everywhere, exactly as it was.

Next steps ​

  • New here? Follow the Quick Start to publish your first showcase in a few minutes.
  • Need testimonials to show first? See Add New Testimonial.
  • Ready to dig into settings? The Carousel page covers the Query Builder, card designs and every shared panel in detail.