Guides

What to Put in a Portfolio (Section by Section, With Examples)

A portfolio isn't a folder of everything you've ever made — it's a curated argument that you can do the job. Here's every section that argument needs, in order, plus the one most people leave out.

The most common portfolio mistake isn't bad work — it's a bad edit. People either dump everything in or agonise over what's "good enough" and never ship. This is the fix: a fixed list of sections, what goes in each, and what to cut. Build to this and you're done.

The five sections every portfolio needs

  1. A positioning headline — who you are and what you do.
  2. Selected work — 3–4 projects as short case studies.
  3. About — a photo and a few honest sentences.
  4. Skills — a compact, believable list.
  5. Contact — every way to reach you, one click each.

That's the whole structure. Everything below is how to fill each one well.

The section everyone forgets: positioning

Most portfolios open with a name and a vague title. The strong ones open with a positioning line — a single sentence that tells the reader what you do and who for. "Front-end developer building fast, accessible web apps." "Brand designer for early-stage startups." It costs one line and it frames everything that follows. Without it, the reader has to guess.

Projects: the heart of it

This is where you win or lose, so give it the most space. For each project, don't paste a screenshot and move on — write a three-line case study: problem, approach (with one interesting decision), and result (even a small, honest one). Three to four strong projects beat ten thumbnails. There's a full framework in how to write a project case study.

About: people hire people

A photo and three sentences: what you do, one thing that makes you you, and what you're looking for. Skip the life story. A real face and a genuine voice do more than a paragraph of adjectives.

Skills: light and honest

List your tools in a compact group. Delete the 1–10 rating bars — nobody believes "React: 9/10," and it invites exactly the interview question you don't want. A plain, grouped list reads as confident.

Contact: make it one click

Email, LinkedIn, GitHub or the relevant profile, and your résumé — each a single click. The number-one reason a warm lead goes cold is a recruiter who couldn't figure out how to reach you.

What to leave out

  • Weak projects. Your worst piece sets your perceived level.
  • Rating bars and buzzwords. "Synergistic team player" says nothing.
  • Dead links. Test every one on your phone.
  • A wall of everything. Curation is the skill you're demonstrating.

Put it together (free)

Once you know the sections, a free portfolio builder lets you drop them into a template made for your field and publish to a shareable link in minutes. Pick a developer template, a designer one, or a photographer one, fill the five sections, and ship. New here? Start with how to make a portfolio with no experience.

Ready to build yours? Create a free portfolio on Atelier — pick a template, add your projects, and get a shareable link in about ten minutes.

Keep reading