Portfolio planning guide
What to Include in a Portfolio Website (and What to Leave Out)
A portfolio is not a storage folder for everything you have done. It is a guided argument that connects the work you want next with evidence from the work you have already completed.
Start with the person who will review it
A recruiter scanning for role fit, a hiring manager evaluating depth, and a client looking for confidence do not need identical information. Choose one primary audience and make its most important evidence easy to find.
Write down the next action you want that person to take. That may be opening a project, downloading a resume, reviewing GitHub, or sending an inquiry. Your navigation and page order should support that action.
For job applications
Lead with role fit, selected projects, relevant experience, and a direct contact path.
For freelance work
Lead with services, comparable outcomes, process, scope boundaries, and an inquiry method.
For students
Lead with direction, selected coursework or projects, contribution, learning, and availability.
The essential portfolio sections
Most useful professional portfolios can be built from six sections. The exact layout can change, but every section should answer a question a real visitor has.
Hero
Your name, current professional focus, and one clear reason to continue. Avoid generic greetings that hide what you do.
About
A short explanation of your direction, relevant background, and how you approach your work.
Selected projects
A curated set with problem, contribution, decisions, evidence, and outcome - not just screenshots.
Experience
Roles and responsibilities relevant to your target, with progression and credible outcomes.
Skills
Capabilities grouped by use. Support important skills with projects or experience instead of treating the list as proof.
Contact
A professional email and relevant profiles. Make the next step obvious and keep every link current.
Add optional evidence only when it strengthens the story
Testimonials, certificates, awards, publications, process artifacts, speaking, and volunteer work can add trust. They are optional because relevance matters more than volume.
Testimonials
Use real, attributable feedback with permission. Do not invent names, roles, or praise.
Credentials
Include certifications and awards related to the work you want. Provide issuer and date when useful.
Process artifacts
Research notes, sketches, prototypes, tests, and technical diagrams can reveal how you work.
Writing and talks
Include material that demonstrates communication or expertise relevant to your target role.
What to leave out of your portfolio
More content does not automatically create more trust. Remove anything that distracts from the role, cannot be explained confidently, or creates privacy and security risk.
- Every project you have ever completed
- Skill ratings or percentages you cannot justify
- Confidential work, customer data, API keys, or private repository details
- Broken demos, inaccessible files, and placeholder links
- Personal information that is unnecessary for professional contact
- Claims about impact that you cannot verify
A practical one-page portfolio order
For a one-page site, a reliable sequence is hero, selected work, concise about section, relevant experience, grouped skills, and contact. Put the strongest evidence early instead of making visitors earn it through a long biography.
A multi-page portfolio can separate detailed project case studies while keeping the homepage focused. Use descriptive internal links such as "Read the inventory dashboard case study" instead of vague labels such as "Learn more."
Sources and further reading
This guide combines Portcraft product experience with the following primary references.