A portfolio should contain nine things: a short profile with a photo and a way to reach you, three to five outcomes that each show the problem, what you did, and the result, a few hard numbers, your work history, your skills, education and certifications, awards, testimonials with real names attached, and your links. The order matters as much as the list. Put the outcomes above the work history, because a reviewer decides whether to keep reading based on proof, not on the sequence of your job titles.
The purpose
What a portfolio is actually for
Before you decide what goes in it, be clear about the job it does. A resume is a claim. It says you increased retention, ran the migration, wrote the launch copy, and it asks to be believed on the strength of your own say-so. A portfolio is where the claim gets its receipt. It exists so that a hiring manager, a client, or a stranger who found your name can check the assertion without asking you for anything.
That framing settles most of the arguments about content. If a section helps someone verify that you did the work and did it well, it belongs. If it is there because a template had a slot for it, it does not. A professional portfolio is not an autobiography, and it is not a design exercise. It is an evidence file, arranged for someone who is impatient and skeptical and reading on a phone between two meetings.
It also settles the question of who you are writing for. Not your peers, and not your past self. You are writing for one person: the reader deciding, in well under a minute, whether to take you seriously enough to spend a real hour on you. Every section below either earns that hour or wastes it.
The checklist
The nine things that belong in a portfolio
This is the whole list. Nothing else is mandatory, and most of what you have seen recommended elsewhere is one of these nine wearing a different name.
01
A profile that lands in one line
A photo, your name, what you do stated plainly, where you are, and how to contact you. Say "product designer working on payments infrastructure", not "passionate creative problem solver". The one-line version is what a reader repeats to a colleague, so write the sentence you want repeated.
02
Three to five outcomes
The heart of the portfolio. Each one is a short case study: the problem, the approach you took, the result, and the numbers. Not a screenshot with a caption. This is the section that changes minds, and it is the reason everything else exists.
03
A handful of hard numbers
Pull three or four figures out of the case studies and show them on their own: users served, revenue moved, latency cut, articles shipped, clients retained. A number a reader can hold in their head survives the tab close. A paragraph rarely does.
04
Work history, kept short
Company, role, dates, and two lines about what you owned there. This section answers "is this person real and employable", nothing more. Resist the urge to restate your resume here. The resume is a link, not a section.
05
Skills, grouped and honest
Group them into capabilities rather than dumping a wall of nouns. "Design systems" with the tools underneath it reads as expertise. Forty-one comma-separated logos read as anxiety. Only list what you would be comfortable being tested on tomorrow.
06
Education and certifications
The institution, the qualification, the year. Certifications earn their place when they are current and relevant to the role you want. Ten years into a career this section shrinks to a line or two, and that is correct.
07
Awards and recognition
Honors, publications, speaking slots, anything a third party chose to give you. Include the issuer and, where you have one, a link to the announcement. Recognition someone else handed you outranks any adjective you hand yourself.
08
Testimonials with a real name
One or two quotes from people you actually worked for, with their full name, title, and where the quote came from. An anonymous "great to work with" is worth nothing. An attributed sentence from a named director is worth more than another case study.
09
Links and one clear next step
LinkedIn, GitHub, your writing, your socials, and a resume the reader can download. End with one obvious action: email me, book a call, hire me for this. A portfolio that ends without an ask makes the reader invent their own, and most will not bother.
The order
Why outcomes go above your work history
Almost every portfolio guide gives you the same nine ingredients and no recipe. The stacking order is where portfolios are won, because the reader is not reading, they are scrolling until something stops them.
Profile first, and keep it to five seconds.
The reader needs to know who they are looking at before anything else makes sense. Name, role, one line of context, contact. Do not open with a long personal essay about your journey. Nobody has agreed to read that yet, and the scroll is already moving.
Outcomes second. This is the whole argument.
Your best case study goes here, above the fold on the second screen. Not your most recent, your best. A reviewer who is skimming should hit evidence at the exact moment they were about to leave. If you bury the proof under a timeline, they will never reach it, and every hour you spent writing it is wasted.
Numbers third, as the pull quote.
Three or four figures immediately after the case studies act as a summary for someone who read nothing carefully. This is deliberate. Most readers do not read carefully, and the numbers are the version of your portfolio that survives a skim.
Experience fourth, once you have earned the credibility.
Now that the reader believes you can do the work, tell them where you have done it. Reversing these two, chronology before proof, is the single most common mistake in the format. It asks the reader to trust your titles before you have shown them anything, and titles are the least interesting thing about you.
Skills, credentials, and awards fifth.
Supporting evidence for a reader who is already convinced and building a case internally. These sections rarely change a mind on their own, but they close the gaps that a skeptical colleague will ask about later, in a room you are not in.
Testimonials and the ask, last.
Finish with someone else vouching for you, then tell the reader precisely what to do next. The final screen is the one they are on when they decide to act. Give them a name to trust and a button to press, in that order.
The cut
What to leave out, and what makes a portfolio good
A good portfolio is defined at least as much by what is missing from it. Cut the references section: nobody calls before an interview, and "available on request" is a phrase that has never persuaded anyone of anything. Cut skill bars that say you are eighty percent proficient in Python, because that number means nothing and everyone knows it. Cut the coursework, the hobbies, and the school project, once you have real work to show. Cut any link that is broken, any project you would not want to be questioned about, and any client logo you cannot honestly claim to have served.
Cut the word "responsible for". It is the softest phrase in professional writing. You were responsible for the migration; did it land, and what happened when it did? The whole difference between a portfolio that works and one that does not is the difference between describing your duties and reporting your results.
What makes a portfolio good is not a theme, a font, or an animation. It is one thing: every claim on the page can be checked. A named client. A number you can defend if you are asked where it came from. A live link. A quote with a full name and a title next to it. Verifiability is the entire game, and it is why a plain portfolio full of proof beats a beautiful one full of adjectives every single time.
The container
Where these nine sections can actually live
The list is only useful if you have somewhere to put it. Here is how the common options hold the structure this post describes.
| Capability | Folio | A PDF or slide deck | A LinkedIn profile | A general site builder |
|---|---|---|---|---|
| Outcomes as problem, approach, result, metric | A structured section with all four fields per case study | Whatever you lay out by hand, page by page | Compressed into the description under a job title | You build the layout and the fields yourself |
| Testimonials with a named source | Quote, author, title, and where it came from | Pasted text a reader has no way to verify | Recommendations, but only from LinkedIn members | Possible, if you design the block for it |
| A downloadable resume attached to it | Built in the same account and exported to PDF or DOCX for free | It is the same file, so there is nothing to attach | A generated PDF of the profile, in LinkedIn formatting | Upload a file you made somewhere else |
| Reordering sections to put proof first | Sections and items are ordered by drag, no code | Re-export the whole document every time | The order is fixed by LinkedIn, not by you | Free to reorder, once you have built each block |
| Sending it as a link, and knowing it was opened | One URL plus first-party analytics on the page | An attachment, and no idea what happened to it | A profile view count with no context | Add and configure an analytics tool yourself |
A PDF is still the right answer for a leave-behind you hand across a table. The point is that the link should exist first, and the file should be exported from it.
The honest numbers
What Folio gives you at no cost, and what it does not
Building the nine sections and exporting a resume costs nothing here. The limits of the free plan are worth knowing before you start, so they are printed below rather than buried.
The build
How to fill all nine sections in one evening
Start with the outcomes, not the design. Open a blank document and write three case studies in four lines each: the problem, what you did, what happened, and one number. That is it. Three by four is twelve lines of writing, and it is ninety percent of the value of the finished portfolio. If you cannot get through that, no theme is going to save the page.
Then pull the numbers out of what you just wrote. Then paste the work history from your resume and cut it in half. Then group the skills. Then message two people you worked with and ask, in one sentence, whether they would write you a short quote about a specific project. Most people say yes, and most people never get asked, which is exactly why an attributed quote is worth so much.
Then, and only then, pick a theme and put it all somewhere with an address you can send. Folio holds each of these nine sections as its own thing you fill in rather than a page you have to lay out, and the resume you export from it is the same content, no retyping. It is free to build, free to publish, and free to download the resume. Fair warning, restated: on the free plan you are on a portfolio.wrxstack.com address with a small "Made with Folio" mark, and the theme gallery is trimmed. Everything in the list above still works.
Frequently asked questions
What should I put in my portfolio?
Nine sections: a short profile with contact details, three to five outcomes written as problem, approach, result and metric, a few standalone numbers, your work history, grouped skills, education and certifications, awards, testimonials with named sources, and your links plus a downloadable resume. Anything beyond those nine is usually one of them in disguise.
What is a professional portfolio, and what does it consist of?
It is the evidence file behind your resume, held at a web address you can send to anyone. It consists of the proof of your work, meaning case studies with results, measurable figures, credentials, recognition, and quotes from people who hired you. The distinguishing feature is that a stranger can check every claim in it without contacting you.
What is a portfolio used for when you apply for a job?
It does the job your resume cannot: verification. The resume gets you past the first filter, and then the hiring manager wants to see whether the bullet points are real. A portfolio hands them the artifact, the number and the named reference, so the interview starts from what you built instead of what you wrote about yourself.
What makes a good portfolio?
Checkability, and the running order. Every claim should be traceable to something a reader can inspect: a live link, a named client, a defensible figure, a quote with a title next to it. Then stack the page so the proof arrives before the chronology, because most readers stop somewhere in the middle and you want them to stop after the evidence.
What should you leave out of a portfolio?
The references section, percentage bars claiming you are eighty percent fluent in a language, unrelated coursework and hobbies once you have real work, any broken link, and the phrase "responsible for". Also cut any project you would rather not be questioned about, because everything visible on the page is an invitation to ask.
Where can I build a portfolio for free?
Folio publishes every one of the nine sections above at no cost, and the resume that goes with it exports to PDF or DOCX with no watermark and no charge. The honest trade on the free plan: your address is portfolio.wrxstack.com/yourname rather than a domain of your own, a small Folio mark is shown, and only the core themes are open.