Testimonials and references on your portfolio: how to ask and use them

Everything else on your portfolio is you talking about yourself. A testimonial is someone else doing it, which is why a good one can carry so much weight. A sentence from a former manager or client saying you made a hard project easier often does more than a paragraph of your own description.

The catch is that testimonials only work when they're real, specific and used with permission. This guide covers who to ask, when and how to ask, how to edit what you receive, where to put it on your page and how testimonials differ from references.

What makes a testimonial useful

Not every kind word makes a good testimonial. Compare these two:

• Vague: "Priya is amazing to work with. Highly recommended!"
• Specific: "Priya rebuilt our volunteer sign-up form in three weeks. The new version was the first one our older volunteers could fill in without calling us for help."

Both are sincere, but the second tells a reader what Priya did, for whom and what changed. A useful testimonial usually includes at least one of these:

• A concrete thing you did.
• A result or a change that followed.
• A quality of how you work, shown through an example.
• Who the person is and how they know you.

You can't write the testimonial for someone, but you can make it much more likely that they give you something specific by how you ask.

Who to ask

The best people to ask are those who saw your work closely and whose role makes their opinion relevant to the visitors you want.

Good candidates include:

• Clients, if you freelance or consult. A client's view is usually what other prospective clients care about most.
• Managers or team leads who directly supervised your work.
• Colleagues you worked with day to day, especially in other disciplines, such as a developer vouching for a designer.
• Course instructors or project supervisors, if you're early in your career or changing fields.

Avoid asking friends or family, even if they've seen your work. Visitors can usually tell, and it weakens the rest.

Two or three strong testimonials are plenty.

When to ask

The easiest time to ask is right after something has gone well: a project has launched, a client has thanked you, or a manager has praised a piece of work. The details are fresh, and the person is already thinking positively about it.

If that moment has passed, it's still fine to ask later. Just remind the person of the specific work so they don't have to dig through their memory.

Be thoughtful about timing with current employers. Asking a manager for a public testimonial while you're quietly job hunting may reveal more than you intend. Former managers and finished client projects are safer.

How to ask

Keep your request short, specific and easy to say no to. A good message usually covers:

• Why you're asking. You're updating your portfolio and would like to include a short quote from them.
• What it's about. Name the project or period of work, so they know what to comment on.
• What would help most. Suggest one or two things they might mention, such as what you did or what changed.
• How long. Two to four sentences is enough. People hesitate when they think they need to write an essay.
• Permission and attribution. Ask how they'd like to be named, and say you'll show them any edits before publishing.
• An easy out. Make it clear that it's fine if they're too busy.

Here's an example in prose that you can adapt:

"Hi Daniel, I'm putting together a portfolio site and I'd love to include a short quote from you about the onboarding redesign we worked on last spring. Two or three sentences would be perfect, something about what I worked on and what difference it made for your team. I'll show you the final wording before it goes live, and let me know how you'd like your name and title shown. And no problem at all if you don't have time right now."

Mentioning a specific project in your request is the single biggest thing you can do to get a specific testimonial back. A general "could you say something nice about me?" usually gets a general answer.

Getting clear permission

Before anything goes on your site, make sure the person has agreed to be quoted publicly, not just that they wrote something kind in an email.

This matters especially for:

• Old messages. A thank-you email from a client two years ago was written privately. Ask before you publish it.
• Reviews from other platforms. Even if a review is public somewhere else, it's courteous, and safer, to check before reusing it with the person's name.
• Employer policies. Some people can't publicly endorse others in their professional role. If so, respect it.

Keep a record of each person's agreement, such as a short email reply saying "yes, happy for you to use that." It's useful if anyone ever asks.

Editing for length without changing meaning

Sometimes you'll receive a long, generous paragraph and want to use only part of it. Editing is fine as long as the result still says what the person meant.

Reasonable edits:

• Cutting a long testimonial down to its strongest sentence or two.
• Fixing an obvious typo.
• Removing an internal reference a visitor wouldn't understand.

Edits to avoid:

• Combining sentences in a way that changes the claim.
• Strengthening the wording, such as turning "helpful" into "essential."
• Adding results or details the person didn't mention.

Here's an example:

Original: "Working with Tom was really easy. He was always quick to respond and very patient with all of our questions, which we had a lot of because we'd never done a website before. The new site was finished on time and we've had lots of good feedback from customers about how easy it is to book online now."

Edited: "Tom was patient with all of our questions, because we'd never done a website before. The new site was finished on time, and customers tell us how easy it is to book online now."

The edited version is shorter but keeps the meaning, including the fact that the feedback came from customers. Whenever you trim, send the final wording back to the person and ask if they're happy with it.

Attribution

A testimonial with no name attached carries very little weight. Visitors want to know who's speaking.

A good attribution includes:

• The person's name, as they've agreed to have it shown.
• Their role or relationship to you, such as "Product manager" or "Client, small bakery."
• The organization, if they've agreed and it's relevant.

If someone prefers not to be named, a partial attribution such as "Operations lead at a regional logistics company" is acceptable, but use it sparingly. Several anonymous quotes in a row can make readers suspicious.

Where to place testimonials

Testimonials work best near the thing they're talking about.

• Next to a project. A client's quote about a specific project belongs on that project's write-up, where it backs up what you've described. See how to write a case study.
• In a short testimonials section. Two or three quotes in their own section, usually after your projects and before your contact details.
• Near your call to action. One strong quote just above your contact section can reassure someone who's about to get in touch.

Avoid putting testimonials above your headline or bio. Visitors need to know who you are before someone else's opinion of you means anything.

References versus testimonials

The two are related but serve different purposes.

Testimonials are short, public quotes on your site. Anyone can read them, and they're there to build trust quickly.

References are people an employer contacts privately, usually late in a hiring process, to confirm your experience and ask questions. Their contact details should not be published on your portfolio.

On your portfolio, it's enough to say something like "References available on request," or to leave references out entirely. Share your referees' details directly with an employer when asked, and give each referee a heads-up before you do. Publishing someone's phone number or email on a public site without a clear reason exposes them to spam, and it's not your information to share. The guide on personal information on your portfolio explains the same principle for your own details.

Never fabricate

It should go without saying, but it's worth stating clearly: never write a testimonial yourself and attribute it to someone else, never invent a client, and never present a paraphrase as a direct quote.

A reader who discovers one invented claim will reasonably doubt everything else on the page.

If you don't have testimonials yet, that's completely fine. Many strong portfolios have none. Let your projects and results speak for you, and add testimonials as you earn them. The guide on quantifying your achievements helps you show impact honestly in the meantime.

Putting it together

A few specific, real testimonials from people who know your work can add credibility that nothing else on your site can. Ask the right people soon after good work, mention a specific project, keep the request short and give them an easy way to say no. Get clear permission, edit only for length, attribute every quote and place it next to the work it describes. Keep references private, and never invent anything.