Add New Testimonial
Add a testimonial from the WordPress admin: the person, their quote, rating, photo and the other details every View and block pulls from.
Before you can display anything, you need testimonials to show. A testimonial is one review: who said it, what they said, their rating, and details like a photo or company. This page walks through adding one from the WordPress admin, field by field.
You only build a testimonial once. After that, both the classic Views and the display blocks read from the same testimonials, so the reviewer you add here is available everywhere.
Open the editor
- In the WordPress admin sidebar, go to Real Testimonials → All Testimonials. This list shows every testimonial you've added, with its photo, reviewer name, groups, star rating and a ready-made shortcode for that one testimonial.
- Click Add New Testimonial at the top of the list.

The edit screen opens with a title field, the testimonial content area, and a Testimonial Options box (its tab reads Reviewer Information) for everything else. On the right sidebar you'll also find the Testimonial Image and Groups panels.

The basics: title, quote and photo
These three use standard WordPress features, so if you've ever written a post, you already know them:
| Field | What it's for |
|---|---|
| Title | A short headline for the testimonial, often the pull-quote, like "Support was outstanding". Keep it punchy, since the full quote goes in the content editor. Some card designs show the title, and it's also how you'll find the testimonial in your admin list. |
| Testimonial content | The testimonial text itself, written in the main editor. This is the quote that appears on your cards. Blocks can trim it to a set length and add a Read More link, but that's a display setting on the block, not something you set here. |
| Reviewer image | The Testimonial Image panel in the sidebar. It's WordPress's usual Featured Image box, renamed. Click Set reviewer image and upload the reviewer's photo. If a testimonial has no photo, blocks and Views fall back to a default avatar you choose in their settings. Still, add one when you can. Cards look far more convincing with a real face on them. |
Reviewer Information fields
The Testimonial Options box under the editor holds the reviewer's details. Every field here is optional. Fill in what you have, then decide block by block which ones show, using the Card Content panel.
Full Name
The person giving the testimonial, e.g. Jane Doe. It shows on the card as the reviewer name, usually the most prominent detail after the quote.
E-mail Address
The reviewer's email. It's stored for your reference, which is handy when a review arrives through the Submission Form and you want to follow up. It is not shown on the front end (the public side of your site that visitors see).
Designation
The reviewer's job title or role, e.g. Marketing Manager. It usually sits right under the name. If you've filled in a Website/Custom Link URL (below), the designation becomes a link to it.
Company Name
The company the reviewer works for or represents. Like the designation, it links to the Website/Custom Link URL when one is set.
Company Logo
An image upload for the company's logo. Some card designs give the logo a lot of space, and a row of logos people recognize does a lot for credibility. For the cleanest result, upload a fairly small image with a transparent background.
Location
Two inputs side by side:
- Location: a free-text field for the city or region, e.g. Austin, TX.
- Country: a dropdown of countries, each with its flag. On the card, the Reviewer Details panel lets you show the country as a flag, the name, or both.
Phone or Mobile
The reviewer's phone number, stored for your reference like the email address.
Website/Custom Link URL
A single URL that the Designation and Company Name link to on the front end. Point it at the reviewer's company site, their portfolio or the original review, wherever a curious visitor should land when they click.
Video Testimonial URL
Paste a video URL here to turn the testimonial into a video review. Three kinds of link work:
- YouTube: any standard YouTube link.
- Vimeo: any Vimeo link.
- Self-hosted video: a direct link to a video file (like
.mp4or.webm), including files from your own Media Library.
When a video URL is set, the card shows a play button over the reviewer image. Clicking it plays the video in a popup or right on the card, depending on the block's or View's settings. Visitors can also record or upload a video themselves through the Submission Form or the Record Video block, and it lands in this field automatically.
This field is what makes it a video testimonial
Filling it in does more than add a play button. It moves the testimonial into your video collection, so it'll appear under Real Testimonials → Video Testimonials and become available to the Video Testimonials block, which shows only testimonials that have a clip. Clear the field and it goes back to being an ordinary written testimonial.
Star Rating
The review score, from 1 Star to 5 Stars (whole stars only). You can leave it unset, and cards just won't show stars for that testimonial. The rating also feeds a few other parts of the plugin:
- The Query Builder's Based on Star Rating filter (e.g. show only 4-stars-and-up).
- The Review Summary child block's average rating.
- The Filter by Rating front-end control.
The date
There's no separate date field. A testimonial's date is its WordPress publish date, so if you want a review dated last March, change the publish date in the sidebar's summary panel. How the date appears (the format, or a relative "2 weeks ago" style) is a display choice you make per block in the Reviewer Details panel.
Groups
Groups are the plugin's taxonomy (WordPress's term for a way of categorizing content, like post categories). You use them to sort testimonials into sets such as Product, Support or Enterprise. They're hierarchical, so a group can have sub-groups.
- Manage them under Real Testimonials → Groups, or create them right from the Groups panel on the edit screen.
- A testimonial can belong to any number of groups.
- Use groups in the Query Builder (Filter Testimonials → Groups) to control what a block shows, and in Filter by Group to let visitors filter live.
It pays to be consistent here. Front-end filters are only as useful as the groups behind them.
Social Profiles module
Add links to the reviewer's social accounts. They show as icons on the card (styled in the block's Social Media panel). This section appears on the edit screen only when the Reviewer Social Profiles module is enabled.
Click Add Social, pick a network from the dropdown, and paste the profile URL. Repeat for as many profiles as you like. The list covers 35 networks, from Facebook, X (Twitter), LinkedIn, Instagram, YouTube, WhatsApp and Yelp to developer favorites like GitHub, Stack Overflow, Dribbble and Behance.
Additional Custom Fields module
When the built-in fields aren't enough (say you want to show Years as customer or Project budget), add your own. This section appears only when the Custom Information Fields module is enabled.
Click Add Field to create a row, then set three things per field:
| Part | What it does |
|---|---|
| Icon | An optional icon shown next to the value on the card. |
| Field type | Text, Number, Email, Link or Date. This controls how the value is treated. A Link shows as a clickable URL, for example. |
| Value | The actual content, e.g. "Customer since 2019". |
Drag rows to reorder them. Custom fields are set per testimonial, not globally, so each testimonial can have its own set.
Disabling a module never deletes data
If you turn off Social Profiles or Custom Information Fields, the saved values stay on each testimonial. They just stop showing. Turn the module back on and they reappear.
Choosing what actually shows
Filling in a field doesn't force it onto every card. Each display block has a Card Content panel where you switch the name, designation, company, location, date, rating and the rest on or off, and each of the six card designs arranges them differently. So enter everything you have. You still decide what shows, block by block.
You don't have to type it all yourself
You can also fill your library without typing anything in: publish the Submission Form block and let customers submit text, photo and video reviews. Each one arrives as a testimonial with these same fields filled in. For video, the Record Video block lets visitors record a clip straight from their webcam.