12 common portfolio mistakes and how to fix them

Most weak portfolios aren't weak because the person lacks talent. They're weak because of a handful of fixable problems that make the work harder to see. The good news is that each of these takes minutes or hours to fix, not weeks.

Below are twelve mistakes that show up again and again, each with a concrete fix. Read through them with your own site open in another tab.

Mistakes in the first few seconds

The top of your page decides whether a visitor keeps reading. These three mistakes happen there.

1. A headline that says nothing

Many portfolios open with just a name, or with something like "Welcome to my portfolio." A visitor arriving from a link doesn't yet know why they should care.

Fix: Write a headline that says what you do and, ideally, for whom.

• Before: "Hi, I'm Sam."
• After: "Sam Rivera, UX designer for healthcare and booking apps."

The guide on portfolio headlines and taglines has more patterns to try.

2. A bio full of adjectives

"Passionate, driven, detail-oriented team player" could describe anyone, so it describes no one. Readers skim past it.

Fix: Replace adjectives with facts. Say what you've done, what you focus on and what you want next.

• Before: "I'm a passionate and creative marketer who loves storytelling."
• After: "I'm a marketer who plans and writes email campaigns for small online shops. For the past two years I've run the newsletter for a small outdoor gear store, growing it from a monthly update into a weekly one."

3. No clear next step

Someone likes your work and then has no obvious way to reach you, or has to hunt for it at the bottom of a long page.

Fix: Make contact easy to find. A contact form or a clear "Get in touch" link near the top and again at the end is enough. Say what you're open to, such as full-time roles, freelance projects or both.

Mistakes in how you present work

These are the most common problems overall, and the ones that most affect how good you look.

4. Showing too much

Twenty projects of mixed quality make the reader do the curation for you. Weak pieces drag down strong ones.

Fix: Pick your best three to six pieces and cut the rest. If you have a wide range, choose the work closest to the job or client you want next. You can always swap pieces in later.

5. Images with no explanation

A grid of screenshots or photos with titles like "Project 1" leaves visitors guessing what the problem was and what you actually did.

Fix: Give each project a short write-up: the goal, your role, what you did and the result. Even three or four sentences change how the work reads. For a fuller structure, see how to write a case study.

6. Hiding your role in team work

"We launched a new onboarding flow" leaves the reader unsure whether you led it or attended one meeting about it.

Fix: Use "I" for your own contributions and be specific.

• Before: "We redesigned the company's onboarding."
• After: "I mapped the existing onboarding steps, ran five interviews with new users and designed the new welcome screens. Our developer built them and a product manager owned the rollout."

That honesty makes you more credible, not less.

7. Results that are vague or inflated

"Significantly improved performance" is too vague. A number you can't explain in an interview is worse.

Fix: Use concrete facts you can stand behind: counts, timeframes, before-and-after comparisons or direct outcomes. If you don't have a metric, describe what changed in plain words. Quantify your achievements walks through how.

Mistakes in writing and polish

8. Typos and inconsistent details

A spelling mistake in your headline, or a job title that differs between your resume and your portfolio, makes careful readers wonder what else is off.

Fix: Read the whole site out loud once. Then compare dates, job titles and company names against your resume and professional profiles. Ask one friend to read it on their phone and point out anything that confused them.

9. Writing for yourself instead of the reader

Long paragraphs about your personal journey, or heavy industry jargon, can lose the person who's deciding whether to contact you. Recruiters and clients are often not specialists in your exact field.

Fix: Write short paragraphs. Lead with what you did and why it mattered. Explain any acronym the first time you use it, or cut it.

Mistakes in upkeep and technical basics

10. Broken links and missing images

A "View live site" link that leads to an error page, or an image that doesn't load, makes the whole portfolio feel abandoned.

Fix: Click every link and check every image after you publish, and again every few months. If a live project no longer exists, replace the link with screenshots and a note saying it was retired.

11. Not checking it on a phone

Many people will open your portfolio from a link in an email or a message, often on their phone. A layout that looks fine on your laptop can be cramped, cut off or hard to read on a small screen.

Fix: Open your site on your own phone and on someone else's. Check that text is readable without zooming, that images aren't cropped strangely and that the contact option is easy to tap.

12. Letting it go stale

A portfolio that still says you're "currently studying" two years after graduation, or lists a job you left long ago as current, tells visitors you've stopped paying attention.

Fix: Put a recurring reminder in your calendar, every three or four months, to review the site. Update your current role, add any new strong work and remove the weakest piece.

A good habit: whenever you update your resume, update your portfolio the same day. Keeping the two in sync avoids the mismatched titles and dates described in mistake 8.

A bonus mistake: sharing too much personal information

Some portfolios list a home address, a personal phone number and a date of birth. None of these help you get hired, and they can expose you to spam or worse.

Fix: Share only what's needed for someone to contact you. A contact form, a professional email address and your general city or region are usually enough. The guide on personal information on your portfolio goes into detail.

A ten-minute self-review

If you only have a few minutes, run through these questions:

1. Does the headline say what I do?
2. Can a stranger find my contact option in under five seconds?
3. Does every project have at least a few sentences of explanation?
4. Is my role clear on every team project?
5. Is every number something I could explain in an interview?
6. Do all links and images work?
7. Does it read well on a phone?
8. Is everything on the page still current?

Any "no" is your next fix. Start with the ones at the top of the list, since they affect the most visitors.

Putting it together

Most portfolio problems come down to clarity, curation and care. Say plainly what you do, show fewer pieces with better explanations, be honest and specific about your role and results, and keep the site current and working. None of these fixes require new skills or a redesign. They require an afternoon and a willingness to cut. Once your site is in good shape, the next step is getting it in front of people: see where to share your portfolio.