How to add testimonials to Hexo
What is Hexo?
Hexo is a fast, Node.js-powered static site generator focused on blogging. Whether you're building a blog, documentation or portfolio, Hexo handles the heavy lifting of converting your content into clean, performant HTML.
Why add testimonials to your Hexo site?
Testimonials build trust with potential customers. Social proof from real users is more convincing than any marketing copy you could write. Display them on your homepage to convert more visitors into customers.
Chirp Form gives you a simple solution that works perfectly with Hexo's static architecture while respecting visitor privacy with EU hosting and GDPR compliance.
How Chirp Form works with Hexo
You'll use <chirp-form> on a submission page and <chirp-feed> wherever you want to display approved entries. Chirp Form handles everything behind the scenes. It stores submissions, filters spam and sends email notifications while your Hexo site stays completely static. Submissions are identified through privacy-friendly cryptographic hashing rather than storing IP addresses or personal data directly.
Installation steps
Step 1: Add the Chirp Form script
Add the Chirp Form script to your Hexo layout file. For most sites this goes in themes/landscape/layout/layout.ejs in the <head> section:
<head>
<!-- Your existing head content -->
<script defer src="https://embed.chirpform.com/latest/chirpform.umd.js"></script>
</head>
The defer attribute ensures the script loads without blocking your page content.
Step 2: Add to your multiple pages
Create a submission page at source/submit-testimonial.md:
---
title: Submit Testimonial
date: 2026-02-02
layout: page
permalink: submit-testimonial/index.html
---
<h1>Share your experience</h1>
<chirp-form form-id="YOUR_FORM_ID"></chirp-form>
Then add the feed wherever you want to display testimonials. For example, in themes/landscape/layout/index.ejs or any page/template:
<section class="testimonials">
<h2>What people are saying</h2>
<chirp-feed form-id="YOUR_FORM_ID"></chirp-feed>
</section>
Replace YOUR_FORM_ID with your actual form ID from your Chirp Form dashboard.
Step 3: Configure your form (optional)
You can fully customize your form fields through your Chirp Form dashboard. The form automatically fetches your configuration and renders everything you've set up.
For styling, you can fully customize the appearance using standard CSS. Check the styling documentation for detailed customization options.