The Actual Work Of Building Something People Open
A writing portfolio is not a gallery of your best attempts. It is a curated set of samples selected to prove you can do the specific job you are applying for, presented in a format that does not require the reader to work for it. Most people I have seen fail at this do so because they include everything they have ever written instead of making editorial decisions. Here is the core principle nobody mentions early enough: your portfolio needs to be readable on a phone screen in under thirty seconds. Editors scan. They do not read. If they cannot find what they are looking for before closing the tab, your sample quality is irrelevant. I once had a client whose portfolio was beautiful—beautiful typography, beautiful layout—but took four seconds per page to load. She lost three clients in a single week because the loading time alone made people bounce. We moved her to a simple static HTML file hosted on a basic server, and her response rate doubled within two weeks.
How To Write A Writing Portfolio
Start by deciding what kind of writing you want to be hired to do. This is the step most people skip because it feels restrictive, but it is the single most important decision. A writer who wants freelance magazine work needs a different portfolio than a technical writer seeking a staff role at a SaaS company. Put different front matter in front of different buyers. The actual construction follows a simple hierarchy. You need a landing page that states what you do in one sentence, three to five samples, and a contact method that works. Nothing more. The landing page should say what type of writing you do and link outward. The samples are the proof. The contact method is the close. I usually recommend keeping it under two hundred words total of your own prose on the front page. Let the samples speak. For the samples themselves, pick work that demonstrates range within your target niche, not variety across unrelated genres. Three strong examples beat eight mediocre ones every time. If you are applying for B2B content roles, show a whitepaper, a case study, and a blog post that converts. If you are applying for narrative journalism, show a long-form piece and two shorter features. Match the format to the buyer.
One thing that trips people up constantly: you do not need permission to include work you wrote for clients, but you often cannot publish the full piece if it was commissioned under an exclusive rights agreement. The workaround I use with clients who run into this is to publish an excerpt or a case study version that describes the project without reproducing the client's confidential data or full copy. This satisfies both the legal constraint and the portfolio purpose. I handled a situation where a former client's NDA covered their entire brand voice guide, which meant I could not reproduce a single published article verbatim. Instead, I recreated the structure and rewrote a comparable sample that demonstrated the same approach. The hiring manager never knew the difference because the skill was visible without the IP. Organization matters more than most writers admit. File naming, folder structure, and navigation labels are not cosmetic. When someone clicks your link, they should land on a page that makes the next click obvious. Use clear titles. Avoid vague labels like "Work" or "Samples." Use "Tech Blog Posts," "Editorial Features," "Whitepapers," things that tell the reader exactly what category they are entering. There is a practical bottleneck worth acknowledging: updating a portfolio is tedious if you build it as a custom site from scratch. Every new sample requires editing HTML or rebuilding pages. For most working writers, a platform like JournoPortfolio, Contently, or a simple Carrd site is faster and less error-prone. The downside is less control over design, but the upside is that you can add a sample in under ten minutes instead of spending an afternoon on CSS adjustments. Choose based on your actual time budget.
Get the Full Details

Include a brief project note with each sample. Two or three sentences explaining the audience, the goal, and the result. This transforms a raw piece of writing into evidence of problem-solving. A sample alone says you can write. A sample plus context says you understand why the writing exists. Proofread your portfolio as carefully as any sample you publish. Typos on a portfolio page signal carelessness in ways that no amount of impressive writing compensates for. I once passed on a candidate whose writing was solid but who had a broken link on their contact page that redirected to a dead domain. The error suggested they would not catch similar issues in client work. The sample quality was good. The portfolio itself failed the basic test. Finally, keep the portfolio current. Remove work you are proud of but no longer representative of the skills you want to sell. An old sample from a different beat or format can confuse a reader about what you do now. Curate ruthlessly. Two strong recent pieces are worth more than four aging ones.