How to write portfolio copy people actually read

Most people don't read a portfolio. They scan it. A recruiter between meetings, a client comparing three freelancers, a hiring manager on a phone: they glance at a heading, read the first line of a paragraph, look at a picture and decide whether to keep going. Your copy has to work for that reader without losing the one who reads every word.

This guide covers the habits that make text easy to scan: putting the point first, keeping paragraphs short, choosing plain words, cutting jargon and writing headings that actually say something. Each section includes a before-and-after rewrite you can borrow.

Why scannable copy matters

When text is hard to scan, readers don't struggle through it. They leave, or they skip the part you most wanted them to see. Long blocks of text, vague headings and buried conclusions all send the same signal: this will take effort.

Scannable writing isn't dumbed-down writing. It's writing that respects the reader's time. It also shows something about you. Clear, organized copy suggests clear, organized thinking, which almost every employer and client is looking for.

Put the point first

The most useful habit in all of web writing is front-loading: put the main point at the start of the page, the section, the paragraph and even the sentence.

Many of us were taught to build up to a conclusion. On a portfolio, that means the conclusion never gets read.

Before and after

Before:

"After spending several years working in a variety of roles across retail and hospitality, and after completing a part-time course in digital marketing, I have recently been focusing on helping small businesses grow their social media presence."

After:

"I help small businesses grow on social media. I came to marketing from retail and hospitality, which taught me how customers actually decide what to buy."

The second version leads with what the reader needs to know. The background comes second, and it now explains why it matters.

Front-loading at every level

• Page: your headline says what you do. See writing a portfolio headline and tagline.
• Section: the first sentence summarizes the section.
• Paragraph: the first sentence carries the main idea; the rest supports it.
• Sentence: the important words come early. "Cut onboarding time in half by rewriting the welcome guide" beats "By rewriting the welcome guide, which had become outdated, I was able to cut onboarding time in half."

Try reading only the first sentence of every paragraph on a page. If that alone tells the story, your copy is front-loaded. If it doesn't, move the key sentences up.

Keep paragraphs short

On a screen, especially a phone, a paragraph of eight lines looks like a wall. Readers skip walls.

Aim for paragraphs of one to four sentences, each about one idea. A single-sentence paragraph is fine when the point deserves to stand alone.

Before and after

Before:

"I led the redesign of our internal reporting dashboard, which was used by around forty managers across the company and had become slow and confusing over the years because new features had been added without any overall plan, so I started by interviewing a dozen managers to understand which reports they actually used and found that most of them relied on only three or four views, which meant we could simplify dramatically, and after testing a prototype with a small group we launched the new version and saw far fewer support requests."

After:

"I led the redesign of our internal reporting dashboard, used by around forty managers.

Over the years, features had been added without a plan, and the tool had become slow and confusing. I interviewed a dozen managers and found most relied on only three or four views.

That meant we could simplify dramatically. After testing a prototype with a small group, we launched the new version, and support requests dropped noticeably."

Same content, but now a reader can follow it, and skim it, in seconds.

Use bullets for lists, not for everything

Bullets are great when you're listing parallel things: services, tools, responsibilities, results. They help readers compare items quickly.

They're less good for stories and reasoning, because they strip out the connecting words such as "because," "so" and "but" that explain why things happened. A case study made entirely of bullets reads like a set of notes.

A simple rule: use bullets when the order doesn't matter much and the items are similar. Use short paragraphs when one thing leads to another.

Choose plain words

Plain words are faster to read and harder to misunderstand. They also sound more confident. Compare:

• "Utilize" and "use."
• "Facilitate" and "run" or "help."
• "Leverage" and "use" or "build on."
• "In order to" and "to."
• "At this point in time" and "now."
• "Spearheaded" and "led."

None of the longer versions add meaning. They just slow the reader down.

The same goes for filler adjectives. "Passionate," "dynamic," "innovative" and "results-driven" appear on so many portfolios that readers no longer notice them. Replace them with something specific you did. For more on that, see showing soft skills on your portfolio.

Before and after

Before:

"I am a passionate, results-driven professional who leverages innovative strategies to facilitate impactful outcomes for stakeholders."

After:

"I plan and run fundraising events for small charities. My last three events each raised more than the one before."

The first sentence could describe anyone. The second describes one person.

Cut jargon, or explain it

Every field has its shorthand. Some of it your readers will know. Much of it, especially internal terms from a past employer, they won't.

Ask two questions about each technical word:

1. Will my main reader know this? A software hiring manager knows common programming terms. A small-business client probably doesn't.
2. Does it add meaning? If a plainer word works just as well, use the plainer word.

When a term is necessary, explain it the first time in a few words. "We moved to continuous deployment, so changes reached users within hours instead of weeks" lets both experts and non-experts follow.

Watch especially for:

• Internal project names: "Project Atlas" means nothing to an outsider. Say what the project was.
• Acronyms: spell them out on first use, unless they're universal in your field.
• Team names and job codes from a previous employer.

Ask a friend outside your field to read one page and underline every word they had to guess. That's your jargon list.

Write headings that say something

Headings are the most-read text on a page after the headline. Many portfolios waste them on labels like "About," "Experience" or "Project 3." Section labels are fine for navigation, but within a case study or long page, headings can carry the story.

Before and after

Before:

• Overview
• Research
• Design
• Results

After:

• Booking took eleven steps, and patients gave up
• Most patients only needed two pieces of information
• A three-step flow that works on any phone
• Phone bookings fell and online bookings rose

A reader who skims only the second set of headings understands the whole project. That's the goal.

Keep headings short, specific and parallel in style, and make sure each one accurately describes what's under it.

Edit in passes

Good copy rarely comes out right the first time. It's easier to edit in separate passes than to fix everything at once:

1. Structure pass: is the main point first on the page and in each section?
2. Length pass: cut anything that doesn't help the reader decide or understand. Aim to remove about a quarter.
3. Paragraph pass: split long paragraphs and turn true lists into bullets.
4. Word pass: swap long words for short ones, cut filler adjectives and explain or remove jargon.
5. Heading pass: read only the headings. Do they tell the story?
6. Read aloud: anything you stumble on, a reader will stumble on too.

Check your copy on a phone before you publish. A paragraph that looks fine on a laptop can fill an entire mobile screen.

Putting it together

Copy people actually read is front-loaded, short, plain and well signposted. Lead with the point, keep paragraphs to a few sentences, use bullets for real lists, swap long words for short ones, explain or remove jargon and write headings that carry meaning. Then edit in passes and check it on a phone. For specific sections, see how to write a professional bio and how to write a case study.