Docs

Testimonial

A customer quote with name, role, photo and rating.

On this page

The Testimonial widget shows what a customer said, with their name, role and photo, and an optional star rating and quotation mark. The photo can sit above the quote, next to the name, or in a column beside the quote. For several testimonials that visitors swipe through, use Testimonial Carousel.

A testimonial on a sand-colored box: a round photo on the left, five terracotta stars, the quote and the name Daniel Brooks, Owner, Harbor Café
The Photo beside quote layout with a star rating.

Add a testimonial

  1. Insert it

    Open Insert in the left panel, find Testimonial under Basic (or type testimonial in Search widgets) and click it or drag it onto the canvas.

  2. Write the quote

    Type the Quote, Name and Role, or double-click them on the canvas.

  3. Add a photo and rating

    Choose a Photo, then turn on Star rating and set the Rating (0–5) if you have one.

  4. Pick a layout

    Choose Photo above, Photo next to name or Photo beside quote in Layout, and style the box on the Design tab.

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing). Text fields and the photo support dynamic tags, for example to build testimonials from a custom post type (see Dynamic tags).

Content tab

Testimonial
SettingWhat it does
QuoteWhat the customer said. Supports dynamic tags.
NameThe customer’s name. Supports dynamic tags.
RoleTheir role, company or location. Supports dynamic tags.
PhotoA photo of the customer. Supports dynamic tags.
ResolutionThe image size WordPress serves. Smaller files load faster; pick one at least as wide as the image is shown. Default: Thumbnail. Shown when Photo has a URL.
Name linkLinks the name, for example to the customer’s website. Supports dynamic tags.
Star ratingShows a star rating.
Rating (0–5)The rating out of 5. Default: 5. Shown when Star rating is on.
Quotation markShows a large quotation mark.
LayoutPuts the photo above the quote, next to the name, or in a column beside the quote. Options: Photo above, Photo next to name, Photo beside quote. Default: Photo next to name.
Stack on mobileMoves the photo above the quote on small screens. On by default. Shown when Layout is Photo beside quote.
AlignmentAligns the testimonial. Options: Left, Center, Right. Per device.

Design tab

Box
SettingWhat it does
BackgroundBackground of the testimonial box.
PaddingSpace inside the box. Per device.
BorderBorder of the box.
Border radiusRounds the corners of the box. Per device.
ShadowShadow of the box.
Spacing between partsSpace between the photo, quote and name. Per device.
Quote
SettingWhat it does
TypographyText style or font, size, weight and spacing of the quote.
ColorColor of the quote.
Max widthLimits the line length of the quote. Per device.
Quotation mark › ColorColor of the quotation mark. Shown when Quotation mark is on.
Quotation mark › SizeSize of the quotation mark. Shown when Quotation mark is on. Per device.
Name & role
SettingWhat it does
Name typographyText style or font, size, weight and spacing of the name.
Name colorColor of the name.
Name link hover colorColor of the linked name on hover. Shown when Name link has a URL.
Role typographyText style or font, size, weight and spacing of the role.
Role colorColor of the role.
Name to role spacingSpace between the name and the role. Per device.
Photo
SettingWhat it does
SizeSize of the photo. Per device.
Border radiusRounds the photo; 50% makes it a circle. Per device.
BorderBorder of the photo.
ShadowShadow of the photo.
SpacingSpace between the photo and the text. Per device.
Stars

This section shows when Star rating is on.

SettingWhat it does
SizeSize of the stars. Per device.
SpacingSpace between the stars. Per device.
Marked colorColor of the filled stars.
Unmarked colorColor of the empty stars.
Shared Design sections

Every element also has these sections at the end of the Design tab.

SectionWhat it does
Spacing & positionMargin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position.
Background & borderBackground, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows.
MaskCrops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks.

Behaviour tab

Behaviour sections

The Behaviour tab is the same for every element.

SectionWhat it does
Anchor & classesAn Anchor ID for #links and your own CSS classes.
AnimationsEntrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects.
Motion & effectsA simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning.
Scroll & mouse effectsMovement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt).
VisibilityHide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility.
ConditionsShow the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions.
InteractionsShow, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions.
AttributesCustom HTML attributes for this element. See Anchor, classes & attributes.

Tips

  • Real words, real people. Use quotes you have permission to publish. A full name and a specific role make a testimonial believable.
  • Short quotes. Two or three sentences are read; paragraphs are skipped. Use Design → Quote → Max width to keep lines comfortable.
  • Photo on phones. With Photo beside quote, Stack on mobile moves the photo above the quote on small screens.
  • Alt text. The photo's alt text comes from the media library; describe the person or leave it empty if the name is right beside it.