How do I add the Testimonials block to a Hugo site?

Add a "block: testimonials" entry to the sections list in your page's front matter, then fill in the content fields. HugoBlox renders it automatically — copy the example config above as a starting point.

Is the Testimonials block free to use?

Yes. Every HugoBlox block is free and open-source under the MIT license — use it in personal and commercial projects, with no attribution required.

Can I customize the Testimonials block?

Yes. It exposes 7 content options, and inherits the shared block settings for background, spacing, and colors. You can also describe the changes you want to Hugo Chat AI and it will edit the config for you.

Does the Testimonials block work with any Hugo theme?

The block ships in the open-source HugoBlox kit. Add the kit to any Hugo site and the block becomes available in your page sections — there is no theme lock-in.

hugoblox.com/blocks/testimonials

Social proofFree · MITPreact · interactive

Testimonials block

Turn happy customers into social proof — quote cards with avatars, names, and roles.

Customize with AI View source

Add it to any Hugo page's sections list — no build step.

v1.0.0Version

7Options

MITLicense

Quick start

Add the Testimonials block

Drop this into your page's front matter, under the sections list. Edit the values, and HugoBlox renders the block — no build step.

Add to your page's sections

- block: testimonials
  content:
    title: What partners say
    text: Teams build faster when they start with Hugo Blox.
    items:
      - text: “Hugo Blox let us ship a research microsite in days instead of weeks.”
        name: Dr. Casey Smith
        role: Research Lead, OpenAI
        image: people/casey.jpg
      - text: “Great developer experience and first-class docs. Our students love it.”
        name: Prof. Lee Nguyen
        role: MIT CSAIL
        image: people/lee.png

Overview

About the Testimonials block

Transform customer voices into powerful social proof

Build unshakeable trust and credibility with the Testimonials block - a sophisticated component that presents authentic customer feedback in a professional, visually appealing format that converts skeptical visitors into confident buyers.

✨ Key Features

Professional Quote Styling: Beautiful quotation marks and elegant typography
Customer Photos: High-quality avatar display with optimized 2x retina images
Complete Attribution: Customer names and roles for authentic credibility
Responsive Layout: Perfect presentation across all device sizes
Multiple Testimonials: Stack multiple testimonials in a clean, organized format
Markdown Support: Rich text formatting for testimonial content
Lazy Loading: Optimized image loading for better performance

🎯 Perfect For

SaaS Platforms: Showcase customer success stories and satisfaction
Service Providers: Display client feedback and project results
E-commerce: Build buyer confidence with authentic product reviews
Consultants: Demonstrate expertise through client testimonials
Agencies: Highlight successful partnerships and outcomes
Course Creators: Share student success stories and transformations

🚀 Why Choose Testimonials Block?

Social Proof Power: Authentic customer voices carry more weight than any marketing message

Visual Credibility: Photos and names make testimonials feel genuine and trustworthy

Professional Presentation: Elegant design elevates customer feedback to marketing gold

Conversion Catalyst: Well-placed testimonials can dramatically increase conversion rates

📊 Trust Building Elements

Visual Quote Marks: Classic quotation styling that signals authentic feedback
Human Connection: Real photos create emotional connection with potential customers
Authority Indicators: Customer roles and companies add context and credibility
Clean Layout: Professional presentation that feels premium and trustworthy

💡 Psychological Impact

Bandwagon Effect: Seeing others' success motivates similar action
Risk Reduction: Real customer experiences reduce perceived purchase risk
Emotional Resonance: Stories connect with visitors on an emotional level
Credibility Transfer: Customer authority transfers to your brand

🎨 Best Practices

Use high-quality, professional customer photos
Include specific details and outcomes in testimonials
Add customer roles and companies for context
Keep quotes authentic and conversational
Mix different types of customers and use cases
Update testimonials regularly to maintain freshness

Transform your happiest customers into your best marketing team with testimonials that build trust, reduce friction, and drive conversions.

Reference

Configuration

Every option the Testimonials block accepts, generated from its schema.

Content options

Properties set under the block's content key.

Property	Type	Default	Description
`title`	`string`	—	Section title (supports Markdown)
`text`	`string`	—	Section description (supports Markdown)
`items`required	`object[]`	—	Testimonial entries
`items[].text`required	`string`	—	Quoted testimonial text (supports Markdown)
`items[].name`required	`string`	—	Person's name
`items[].role`	`string`	—	Role or organization
`items[].image`	`string`	—	Avatar filename in assets/media/. Image is processed to 96x96 (displayed at 48x48 for retina).

Compose

Works well with

Blocks that pair naturally with Testimonials on the same page.

CTA Card Hero Logos Stats

Frequently asked

Testimonials block FAQ

Add a "block: testimonials" entry to the sections list in your page's front matter, then fill in the content fields. HugoBlox renders it automatically — copy the example config above as a starting point.

Ready to build with the Testimonials block?

Customize with AI View source