Submission Form
Build a customizable front-end form and collect testimonials, with a rating, photo and even a recorded video, straight from your visitors.

The Testimonial Submission Form block (a building block you drop into a page) lets visitors write a review right on your site. They leave their name, a star rating, a few words, and if they like, a photo or a webcam video. They don't need an account. Each submission lands in Real Testimonials → All Testimonials as pending by default, so nothing goes live until you approve it. After that it shows up in every display block, same as a testimonial you added yourself. The form can sit inline on the page or hide behind a popup button.
When to use it
- You want happy customers to leave a review without emailing you or logging in.
- You'd like photo and video testimonials, which feel more believable than text alone.
- You want feedback while it's fresh, right after a purchase, an event or a support chat. Link a "Leave a review" page from your receipt or thank-you email.
How to add it
- Edit the page or post where you want the form, click the + block inserter, and search for Testimonial Submission Form (under the Real Testimonials category).
- Insert it. A ready-to-use form appears with the default fields (the boxes people type into) already in place.
- In the inspector on the right (the settings sidebar), choose whether the form shows Inline on the page or as a Popup, then tune the fields, button and messages.
- Publish the page. You're now collecting reviews.
Let AI set it up
Rather type what you want than click through panels? If the Build with AI module is on and you've connected an AI provider in AI Configuration, you can describe the form in plain words:
- Build with AI, in the editor's top toolbar, creates a new form from a plain-words description, such as "a review form without the company field". The Short Review Form starter in its list is a good first try.
- Refine with AI, in the block's own toolbar, changes the form you've selected, for example "make the form dark with rounded inputs".
Either way, the AI works with the fields already in the form. It can show, hide, relabel or require them, and it can restyle the form. It won't add new fields. It also leaves your status, notification, redirect, terms link and spam settings alone, so those are always up to you.
Finding your way around the inspector
Select the block and open the inspector, the settings sidebar on the right. As with the display blocks, you'll see a stack of collapsible panels, and most of them have Settings and Style tabs inside:

| Panel | What it controls |
|---|---|
| Form Builder | Display mode, the fields themselves, spam protection, terms, and the form's overall layout and box. |
| Popup Settings | The trigger button (Popup mode only). |
| Input Fields | The field layout style, spacing, and the look of labels, notes and inputs. |
| Submit Button | The button's label, icon, width and styling. |
| Status & Message Settings | What happens to a submission and what the visitor sees afterward. |
| Email Notification Control | The three notification emails: Admin, Awaiting and Approval. |
| Motion Effects | Entrance animation and scrolling effects (shared with display blocks). |
| Advanced | Per-device visibility and custom CSS fields (shared with display blocks). |
The sections below walk through each panel in order.
Form Builder
This is the panel you'll spend the most time in. It decides what goes in the form and how the form sits on the page.
Settings tab

| Control | What it does |
|---|---|
| Form Display Type | Inline (default): the form sits directly in the page, always visible. Popup: the page shows only a trigger button, and the form opens in an overlay. |
| Input Fields | The drag-to-reorder field builder. See The form fields below. |
| Google reCAPTCHA | Spam protection (reCAPTCHA is Google's "prove you're human" check). Off by default, and only shown when the Spam Protection module is on. See Spam protection before you switch it on. |
| Accessibility | On by default. Leave it on. |
| Terms and Conditions | Adds a required consent checkbox, useful when you need explicit consent (for GDPR, say). Turning it on reveals Terms Text (default By submitting, you agree to our), Terms Link Text (default Terms and Conditions.) and Terms And Conditions URL, the page the link opens. Swap the placeholder # in the URL for your real terms page. |
| Alignment | Align the form's content Left (default), Center or Right. |
| Fields Gap | Vertical space between fields. Default 24 px on desktop, 18 on tablet, 12 on mobile. |
| Max Width | The form's maximum width. Default 640 px on desktop and tablet, 400 on mobile. |
The form fields
Everything the visitor fills in comes from the drag-to-reorder list in this panel. Drag a field to move it, or click it to open it up and change the wording. Click × to remove a field. To bring in one you haven't used yet, click Add New Field.
A brand-new form starts with these seven fields, each at full width:
| Field | Required? | Notes |
|---|---|---|
| Full Name | Yes | The reviewer's name. |
| E-mail Address | Yes | Used for notification emails. It isn't shown publicly. |
| Designation | No | Job title or role. |
| Company Name | No | Where they work. |
| Star Rating | Yes | Five clickable stars. No star is pre-selected, so the visitor has to pick one before the form will send. |
| Testimonial Title | No | A short headline that becomes the testimonial's title. Capped at 50 characters to start. |
| Testimonial Text | No | The review itself, which becomes the testimonial body. Capped at 500 characters to start. |
Add New Field offers these extras:
| Field | What it collects | Extra options |
|---|---|---|
| Location | The reviewer's city | Turn on Show Country Selector to add a country dropdown as well. |
| Phone or Mobile | A phone number | Saved as digits plus + and -. Any other characters are stripped out. |
| Website | A URL | |
| Groups | Which group the review belongs to | Select Categories limits which groups are offered. Allow Multiple Selection lets the visitor pick more than one. |
| Photo | A profile photo | Becomes the testimonial's image. JPG, PNG, GIF or WebP, up to 5 MB. |
| Video URL | A video testimonial | Video Type: By URL takes a link. Record lets the visitor record with their webcam. For Record, you also set the Record Label (default Leave A Video Review), the Record Button Text (default Record video), a Recording Time limit (1–5 minutes, default 2) and the Format (WebM or MP4). Recorded uploads can be up to 64 MB, or less if your web host's PHP upload limit is lower. |
| Social Profile | Links to the reviewer's social accounts | Select Social Networks limits which of the 35 supported networks appear. |
| Custom | Any extra info you define | Pick the Field Type: Text, Number, Email, Link or Date. |
Open any field to change its Label and Placeholder, add a Note (small helper text under the field), or mark it Required. Field Width is a percentage, so giving two fields 50% each puts them side by side.
The Title and Text fields also get a length control (Title Length / Text Length). Choose Unlimited, or pick Limited and set a cap in words or characters. Visitors see a live counter beside the label, such as 12 characters out of 50. With a character limit they can't type past it. With a word limit, extra words get trimmed as they type.
RESET replaces your fields
The RESET link above the list asks for confirmation, then puts the starter fields back and throws away your changes to them. Heads up: the starter set isn't laid out quite like a brand-new block. Full Name, E-mail Address, Designation and Company Name sit two per row at 50% width, and Title and Text have no length limit.
Some fields depend on a module
The Social Profile and Custom fields need the Reviewer Social Profiles and Custom Information Fields modules. When a module is off, its field disappears from the editor and isn't collected on the front end.
Style tab

This tab styles the box around the whole form. Background Type is white unless you pick a color, gradient or image. Border is off by default, Border Radius is 12 px, and Box Shadow adds a soft drop shadow out of the box. Round it off with Padding (default 32 px) and Margin. In Popup mode, the form keeps this same box inside the overlay.
Popup Settings
(Shown only when Form Display Type is Popup.)
- Settings tab: the trigger button's Label (default Write a Review) and Alignment (default center).
- Style tab: Typography, Color and Background Color in Normal and Hover states, then Border, Border Radius, Padding and Margin.
On the live page, visitors can close the popup with the × button or by clicking the dimmed area around the form.
Input Fields
Come here when you want to change how the fields look, rather than which fields the form has.
Settings tab

| Control | What it does |
|---|---|
| Input Style | Style One (default) puts each label above its input. Style Two moves the label into a narrow column (30% of the row) on the left, with the input beside it. Switching style doesn't touch field widths. You set those per field with Field Width in the Form Builder. |
| Label to Input Gap | Space between a field's label and its input. Default 12 px (8 on mobile). |
| Input to Note Gap | Space between the input and its helper note. Default 8 px (6 on mobile). |
Style tab

The tab is split into three sections:
- Label: Typography (default 16 px), Color, and the Required Color used for the asterisk.
- Note: Typography (default 14 px, italic) and Color for the helper text.
- Placeholder: despite the name, this styles the inputs themselves. Typography (default 14 px), then Color, Background Color and Border for Normal and Focus states. Out of the box the border is a light-gray solid line that turns your primary color on focus. Border Radius (4 px) and Padding come last.
Submit Button
The button visitors click to send their review.
Settings tab

| Control | What it does |
|---|---|
| Show Icon | Add an icon to the button (off by default). Pick an Icon Source, either the built-in Library or a Custom upload, then set the Icon Position (Left or Right, default Right) and Icon Size (default 16 px). |
| Button Label | The button text. Default Submit Testimonial. |
| Button Width | Full Width (default) stretches the button across the form, keeping the label and icon centered. Auto sizes it to its text and adds a Button Alignment choice (default left). |
Style tab

Match the button to your site's other buttons here. You get Typography, then Color, Background Type and Border for Normal and Hover states, plus Border Radius (default 4 px), Padding and Margin (32 px above by default).
Status & Message Settings
Here you decide two things: what happens to a review once it's sent, and what the visitor sees next.
Settings tab

| Control | What it does |
|---|---|
| Testimonial Status | How each submission is saved: Pending (default, waits for your approval), Private, Draft, Auto Publish (goes live immediately), or Auto Publish Based on Star Rating. |
| Minimum Rating to Publish | (Rating-based status only) Publish automatically only if the rating is at least this many stars (default 4). Lower ratings stay pending. |
| Required Notice + Notice Label | On by default. Shows a reminder (default "Red asterisk fields are required.") when someone tries to submit with a required field empty. |
| Ajax Form Submission | Send the review without reloading the page (that's what "Ajax" means). On by default. |
| Redirect After Submit | Same Page (default), To a Page (pick one in Select Page), or To a Custom URL (type it in Custom URL). |
| Successful Message | Shown after a successful submission. Default "Thank you! Your testimonial is currently waiting to be approved." If you use Auto Publish, reword it so it doesn't promise a wait. |
| Error Message | The fallback shown when a submission fails. Default "We encountered an issue while processing your testimonial." |
| Message Position | Show the message at the Top (default) or Bottom of the form. |
| Hide Form After Submit | Hide the fields and button once the review is sent, leaving just your message. |
Style tab

Just two settings here: Success Message Color and Error Message Color.
Email Notification Control
The form can send three emails, and you write each one yourself. You set them up right here in the block, not on a global settings page. Use the Admin, Awaiting and Approval buttons at the top to switch between them. Each has its own on/off toggle (Admin Notification, Awaiting Notification, Approval Notification), and all three are on by default:
- Admin: sent to you on every submission.
- Awaiting: a friendly "we got it" note to the reviewer when their testimonial is not published straight away (Pending, Draft or Private).
- Approval: sent to the reviewer when their testimonial is published the moment they submit (Auto Publish, or a rating that meets your threshold).
Approving later doesn't send the Approval email
The Approval email only goes out at the moment of submission. If a review comes in as Pending and you publish it yourself later, the reviewer doesn't get an email.

Switch a toggle on and four fields appear:
- To (Admin) or Reply To (Awaiting and Approval): the address the email is sent to. Yes, even the one labeled Reply To. Admin defaults to
{admin_email}, your site's admin address. Awaiting and Approval default to{author_email}, the address the reviewer typed in. - From: the sender shown in the inbox.
- Subject and a rich-text Message Body.


To pull the visitor's answers into an email, drop merge tags into any field. You'll find the list under the editor as Available Tags:
{name} · {email} · {position} · {company_name} · {location} · {phone} · {website} · {video_url} · {testimonial_title} · {testimonial_text} · {groups} · {rating} · {site_title}
{admin_email} and {author_email} work too, as the defaults show.
Motion Effects
(Shown when the Motion Effects module is on.) Want the form to fade or slide in as visitors scroll to it? This panel adds an entrance animation and a scroll effect. The controls match the display blocks, and the Carousel page explains each one.
Advanced
You get two tabs: Visibility (Hide on Desktop / Tablet / Mobile) and Advanced (Custom CSS Class and Custom CSS ID). They behave the same as the display blocks' Advanced Settings. There's no General tab here, since you style the form's box in Form Builder → Style instead.
Using the form inside a Review Summary
A Review Summary block can hold a Submission Form, and its Write a Review button opens that form in a popup. Since the Review Summary already provides the popup, a form nested inside it is always Inline. You won't see the Form Display Type choice or the Popup Settings and Motion Effects panels, and a form set to Popup switches back to Inline when you move it in. The fields, button, messages and emails all work as described on this page.
Video and photo testimonials
Text reviews are great, but a face or a voice is more convincing. The Photo and Video URL fields make that possible:
- An uploaded photo becomes the testimonial's image automatically.
- A video can be a link the visitor pastes, or a clip they record on the spot with their webcam (Record / Stop, up to your time limit).
Want a page built around the camera instead? The Record Video block puts the recorder first and the form fields beside it.
Recording needs HTTPS
Browsers only give camera and microphone access to secure sites, so webcam recording only works when your site is served over HTTPS. A pasted video URL works anywhere.
Spam protection
A public form will attract spam bots sooner or later. When the Spam Protection module is on, a Google reCAPTCHA toggle appears in the Form Builder panel (off by default). Switch it on and the form adds Google's "prove you're human" check, then verifies it on submit so bots get blocked.
Add your keys before you switch it on
The reCAPTCHA version and site/secret keys come from the Spam Protection module (the settings icon on its card in Modules), not from the block. The block toggle only switches the check on. Without keys the check can't run, and every submission is refused with "Captcha verification failed." Logged-in administrators see a notice about the missing keys on the live page. Visitors don't.
On top of that, every submission carries a WordPress nonce (a one-time security token), and uploaded files are checked for type and size. Photos (JPG, PNG, GIF or WebP) can be up to 5 MB. Videos (MP4, M4V, WebM, OGV, MOV or MKV) can be up to 64 MB or your host's PHP upload limit, whichever is lower.
What happens when someone submits
Here's what happens behind the scenes, from click to inbox:
- The visitor fills in the form and clicks submit. The browser won't send it until every required field (including the star rating) is filled in.
- The plugin verifies the security nonce, the terms checkbox if you added one, and the reCAPTCHA if it's on.
- It re-reads your block's settings from the server (so they can't be tampered with) and cleans up every field.
- A new testimonial is created with the Testimonial Status you chose: Pending by default, so it stays unpublished until you review it. If the visitor left the title blank, the testimonial is saved without a title.
- Group picks are saved as groups, an uploaded photo becomes the testimonial image, and a recorded or linked video is attached.
- Your configured notification emails go out.
- The visitor sees your Successful Message, and the form clears, hides or redirects, depending on your settings.
If something goes wrong, the visitor gets an error message instead. When the plugin knows the cause, it says so, for example "Captcha verification failed." or "Please accept the terms and conditions before submitting." Otherwise they see your Error Message.
If the video is what failed, the plugin rolls back the whole submission, so you won't end up with a half-saved testimonial missing its clip. The visitor sees exactly what went wrong so they can fix it:
- "That video is too large to upload. The maximum is …": the file is bigger than your host allows.
- "That video is too large. The maximum is …": the file is bigger than the form's own limit.
- "Your video did not finish uploading. Please try again."
- "That video format is not supported. Please upload an MP4, WebM, MOV, OGV or MKV file."
- "We could not save your video. Please try again."
The new testimonial then waits for you in Real Testimonials → All Testimonials, where you can review, edit and publish it. Add New Testimonial explains what each saved field means.
Tips & best practices
- Keep it short. People are far more likely to finish a form that asks for just a name, a rating and a message. Make everything else optional, and remove fields you don't need.
- Use Pending status (the default) on a public form so you can check reviews before they appear. Keep Auto Publish for trusted, private audiences.
- Turn on Spam Protection, add your reCAPTCHA keys, and only then switch on the block's reCAPTCHA toggle. Send yourself a test review afterward.
- Popup mode with a "Leave a review" button keeps a busy landing page uncluttered.
- Set a real From address on your notification emails. They're less likely to end up in spam.
- Check the length limits. A new form caps the review text at 500 characters. Want longer stories? Switch Testimonial Text to Unlimited.
Prefer a classic shortcode form?
You can also build a submission form the classic way in the admin and place it anywhere with a shortcode (a short bit of text in square brackets that WordPress swaps for the real form). The Classic Form Shortcode block covers how.