Listen to this article
You finally got the portfolio into shape — case studies written up, best five pieces front and center, clean URL. Then you open your resume template and freeze on one line: where does the link actually go, and will pasting it there turn into a wall of blue underlined text an ATS chokes on? That second question is the one nobody answers clearly, because most advice stops at "add a link" and never says how.
Here's the short version: the portfolio link on your resume belongs in the header, written as a plain, full URL, not buried inside a graphic or a QR code. If your format allows a second mention, repeat it once next to the single work sample most relevant to the job. Everything below is the reasoning and the exact placement rules, for designers and developers as much as for marketers, writers and photographers.
Where the link actually belongs
The header is the only part of a resume every parser and every human reliably reads in full. That makes it the right home for your portfolio URL — treat it the same way you treat your email address, not as a design flourish.
Practical placement, in order of how safe it is:
- Contact line, next to email and phone. This is the safest spot. Recruiters expect it there, and ATS fields that map "contact info" pick it up alongside your other details.
- A dedicated line just below your name and title, if your header has room. Fine for a photography, writing or design portfolio where the link is core evidence, not an extra.
- Inside a bullet point in your experience section, once, on the project most relevant to the job you're applying for. This supplements the header link — it doesn't replace it.
What doesn't work: a link only inside a footer, a sidebar graphic, or a QR code. Sidebars and text boxes are exactly what breaks in a lot of parsers (the same layout risk covered in the ATS-friendly format guide), and a QR code has no text for a machine — or a recruiter skimming on a laptop — to read at all.
How to hyperlink it without confusing ATS
A hyperlink is two things layered together: the visible text and the underlying address. Word processors let you hyperlink the word "Portfolio" while the actual URL sits invisibly underneath. That's the habit to break.
- Show the real URL as the visible text. Write `yourname.com/portfolio`, not "click here" or "Portfolio." If a parser strips formatting and keeps only visible text, you still end up with something a recruiter can read and retype.
- Skip link shorteners. A bit.ly or tinyurl link reads as generic and, to a wary recruiter, mildly suspicious — they can't tell where it leads before clicking. Use your own domain or the platform's clean profile URL instead.
- Drop the "https://www." prefix in the visible text if your platform allows it — `yourname.com/portfolio` is shorter and just as functional once hyperlinked underneath.
- Keep one format for every link in the header. If your portfolio link is styled and colored, your LinkedIn and email should match. Inconsistent styling is a small tell that the document was assembled in a hurry.
- Test what survives copy-paste. Paste your resume text into a plain text editor. If your portfolio link turns into blank space or a broken fragment, an ATS parser will very likely see the same thing. This is a two-minute check worth doing before every application round, and it matters more than which file format you send — that trade-off is covered separately in PDF or Word: which passes ATS.
It's not just designers and developers
Portfolio links used to be treated as a design-and-dev-only line item. That's outdated. Any role where the work itself is visible benefits from one link to evidence, formatted the same way:
- Marketing and content roles — a link to a campaign case study, a content hub you built, or a portfolio of writing samples with results attached.
- Writers and editors — a Contently, Muck Rack, Substack or personal-site link showing published bylines, not just a list of publication names.
- Photographers and visual roles — a gallery link, ideally one curated page rather than a raw Instagram grid.
- Anyone with a strong LinkedIn presence doing double duty as a portfolio — still list it as its own line, don't fold it into a sentence.
The formatting rules don't change by field. What changes is what the link needs to prove: for a developer, working code; for a marketer, a result; for a writer or photographer, a body of finished, published work.
The checklist: run your resume against this
- Portfolio URL appears in the header, not only in the body or footer.
- The visible text is the actual domain, not "click here," "portfolio," or a bare icon.
- No link shortener — it's your own domain or the platform's clean profile URL.
- No QR code carrying the only copy of the link.
- The link isn't trapped inside a text box, sidebar, or graphic element.
- You've copy-pasted the resume into plain text and the link still reads intact.
- If repeated in a bullet, it appears once, on the most relevant project only.
- Header link styling (color, underline) matches your email and LinkedIn formatting.
If every item on that list checks out, your portfolio link is about as ATS-safe as it can be — the remaining variable is the parser on the other end, which no one outside the software vendor fully controls.
Once the link survives the software, the sentence around it still has to survive a recruiter. If you're not sure your bullets actually point a reader toward the right project, or your header reads flat next to the link, Kaeros offers a free CV review — a real person reads it and tells you what's working, what raises doubts, and what to fix first, before you spend anything.