Portfolio proof
Testimonials on Portfolio Project Pages
A portfolio shows what you made. The client’s words next to it show what it did for them, and that second half is what a prospective client is really buying. Most portfolios keep the two apart: images on the project page, quotes on a testimonials page nobody opens. Score each pairing and put the right quote on the right project.
- Rate one testimonial against one project
- See exactly what makes the pairing weak
- One matched quote per case page
The problem, solved
Why project pages lack the client’s voice, and how StoryProof adds it
The project pages are images only
A visitor sees the finished work but not whether it was on time, on brief or worth the money. Those are the questions that decide a commission.
With StoryProof: Build a small widget for each project holding only that client’s testimonial, and place it beside the images.
Which quote belongs to which project?
A client who hired you three times wrote praise about one of the jobs, and nobody noted which.
With StoryProof: Tag each testimonial with the project it describes, so finding the right one for a case page is a filter, not an inbox search.
The client’s praise is a two word email
“Love it, thanks!” at handover is sincere but says nothing a stranger can use.
With StoryProof: Send the client a collection link asking what changed after the project went live. They can type, record audio or film a short video.
The portfolio builder has no testimonial field
Portfolio templates have slots for images and a description, rarely for a client quote.
With StoryProof: Paste the widget div into a text or code block on the project page. The embed script loads once in the site footer and fills it.
Flip the switch to see how StoryProof handles each one.
Free scorecard
Score one project and its testimonial
Open the project page and the testimonial side by side. Rate the pair, not the quote alone.
The score is worked out in your browser. Nothing you enter is sent or saved.
A matched project and quote
Illustrative sample, not a real client
Project: a booking website for a small physiotherapy practice, shown with three screenshots.
Testimonial chosen: two sentences from the practice manager saying the new booking page cut phone calls at reception and that changes were handled within a day.
Why it fits: it names a result visible in the screenshots (the booking page) and one thing about the process (quick changes).
Placement: directly after the summary paragraph and before the second screenshot.
- Tag
- project: physio booking site
- Widget
- One testimonial, single quote layout
In StoryProof
Pair them in StoryProof
Step 1 of 4
Tag existing testimonials by project
Use the project’s name as the tag, so each case page has its own filter.
Step 2 of 4
Ask clients of unpaired projects
For projects with no matching quote, send that client a collection link with one question about the result.
Step 3 of 4
Approve and score
Approve what comes back, then run the scorecard on the pair before it goes on the project page.
Step 4 of 4
One widget per project
Build a widget holding just that project’s testimonial and paste its div into the project page. The footer script fills it.
Before you start
Before you pair them
What this does not cover, and what to check on your side. Better to know now than after launch.
- 01
One widget per project adds up
Widgets per workspace: Free 1, Starter 5, Pro unlimited. A small "Powered by StoryProof" badge shows until Pro.
- 02
Confidential work stays out
A client who agreed to a testimonial may not have agreed to the work being shown. Check both.
- 03
Agency work for an end client
If you worked through an agency, the agency and the end client may each need to agree before you show the project with a quote.
- 04
Praise about you, not the project
A testimonial about your personality suits an about page. On a project page it does not answer what the work achieved.
FAQ
Questions people ask
Short answers to what usually comes up next.
Should testimonials go on each project page or on a separate page?
Both, if you can. Project pages are where visitors judge your work, so the matching quote belongs there. A separate page catches the visitors who want to read everything.
Where on a project page should the testimonial sit?
Near the top, after the short summary and before the long scroll of images. Many visitors never reach the bottom of a case page.
What if a client loved the project but will not give a quote?
Show the work without one. Paraphrasing what they said privately, or implying a quote, is worse than an honest gap.
Can one testimonial appear on two project pages?
Only if it genuinely covers both projects. Otherwise it reads as filler to anyone who opens both pages.
Is a video testimonial too much on a project page?
Not if it is short and about that project. Place it below the main image so the work is still the first thing seen.
Still have a question? Ask the StoryProof team or book a demo.
Give every project its client’s voice
Tag your testimonials by project, ask for the missing ones, and place one quote per case page.
Last updated 2026-11-05.