How to Make a One-Page PDF That Sends Recruiters to Your Live Portfolio

November 5, 2026 · 15 min read

By Ahmed HusseinFounder of Seera · Software Development Engineer at AmazonReviewed by Mazen Ahmed

Quick answer: Put your portfolio address in the contact line at the top of the page, written out as text (yourname.com, not the word "Portfolio"), and make that same text a clickable link. Export a text-based PDF and click the link once in the exported file. We built one resume in 14 versions and ran each through text readers: the written-out address came through in every layout we tried, and every version that hid it behind a word, an icon, an image, a Word header or a text box lost it in at least one reader. Job postings rarely set the rules for you: of the 14,359 English postings in our index that ask for a resume, about 6 in 100 name a file type, and only 27 employers state a page limit. When an application form wants a portfolio file instead, send a one-page PDF portfolio whose projects each link to the live case study. Career Mode finds the postings worth sending it to.

A man at a wooden desk reads a single printed page while an open laptop beside him shows a gallery of photos

Image credit: Michael Burrows / Pexels

Where the numbers come from: The parser test is ours, run on November 5, 2026. We wrote one invented one-page resume (Jordan Ellis, product designer; the address sits on example.com, a domain reserved for examples) and made 9 PDF and 5 Word versions that differ only in how the portfolio link appears. The PDFs were printed from a web page by Chrome, the Word files built with the python-docx library. Each PDF went through two open-source text readers (Poppler's pdftotext and pypdf's text layer) and Seera's own resume reader, which also reads link targets; each Word file went through macOS's built-in converter and Seera's reader. It tests what a file's text layer holds, not any commercial applicant tracking system. Posting counts: Seera's job index as read on November 5, 2026, with 397,549 open jobs taken from 36,000+ employers' career sites; 271,569 of them are in English. We tagged them with keyword rules, checked the rules by reading samples of what they matched, and count employers as well as postings, because one employer's template can repeat across hundreds of postings. The resume numbers come from the 1,016 portfolios on Seera built from an uploaded resume, counted in aggregate; they include links owners added later in the editor, so read them as an upper bound. No employer or person is named.


Key Takeaways

QuestionShort answer
Where does the portfolio link go?The contact line under your name, written out as text and clickable
A link on the word "Portfolio" or an icon?Clickable for a person, invisible to the two text-only readers we tried
Long case-study links?Keep each on one line; a wrapped address came out broken in both text readers
Word files?Keep the link out of the header, footer and text boxes
What do postings require?Rarely anything: about 6 in 100 that ask for a resume name a file type; 27 employers state a page limit
One page or two?One is the safe default early in a career; 36 of the 56 postings that state a limit say one page
When to send a PDF portfolio?Only when a form wants a file; every project in it links to its live case study

Table of Contents


What Job Postings Say About Your Resume File

Most advice about resume files reads like a set of rules: PDF only, one page, link in the header. So we checked how often employers actually write those rules into a job posting. Of 271,569 English postings, 36,503 mention a resume or CV and 14,359 ask for one in their application instructions ("submit your resume and a short cover letter"). Agency disclaimers such as "we don't accept unsolicited resumes" don't count as asks.

What the posting saysPostingsEmployers
Asks for a resume or CV14,3592,616
Names PDF near that ask355 (2.5%)77
Names Word or .docx near that ask685 (4.8%)45
States a page count for the resume5627
  of which one page / up to two / three or more36 / 17 / 3
Asks for any link (portfolio, LinkedIn, GitHub, website)1,316286
Asks for a link to your portfolio1,051 (738 from one employer's template)142
Asks for a link right next to the resume ("a resume with links to your work")20978

Three things stand out. First, the file type is almost never specified, and one firm's template accounts for 411 of the 685 Word mentions; PDF requests are spread across more employers. Second, page limits are close to nonexistent in posting text: 27 employers out of the 2,616 that ask for a resume, and most of those who set one say one page. Third, explicit link requests are rare. One employer's postings all end with a reminder to include links to your portfolio and LinkedIn; set that template aside and 313 postings from 141 employers ask for a portfolio link, about 4 in 10 of them for design roles.

So the posting rarely decides your format. Two readers do: the software that turns your file into text, and the person who opens it. The rest of this guide is about satisfying both with one page.


The Parser Test: One Resume, 14 Versions, One Link

To see what happens to the link, we made one invented resume and changed only how the portfolio address appears. A version passes a reader when the full address comes out of the file intact, with no break inside it. "Clickable" means the PDF still carries a link a recruiter can click on screen.

PDF versionClickableText readers (pdftotext, pypdf)Seera's reader
Full address written out in the contact line✅✅ ✅✅
Short address without https:// written out✅✅ ✅✅
Address written out in a two-column sidebar✅✅ ✅✅
Address written out in a contact table✅✅ ✅✅
Only the word "Portfolio" linked✅❌ ❌✅
Only a globe icon linked✅❌ ❌✅
Name and contact line as one image❌❌ ❌❌
The same image with a link on it✅❌ ❌✅
A long case-study address that wraps onto a second line✅❌ ❌✅
Word (.docx) versionmacOS converterSeera's reader
Address written out as a link in the body✅✅
Address written out in a table cell✅✅
Only the word "Portfolio" linked❌✅
Address in the page header❌❌
Address in a text box✅❌

What the results say:

What an ATS-Friendly Resume Means for Your Portfolio Link

"ATS-friendly resume" usually means a file whose text a program can read in the right order: real text rather than an image, standard section names, no information that lives only in a graphic. For the portfolio link the test adds one rule: the address has to be part of that visible text. A link target hidden behind a word is extra data that some programs read and others skip, and a program that keeps only the plain text never sees it. We didn't test commercial applicant tracking systems, and they differ; the safe layout is the one that works for the simplest reader.


  1. The contact line under your name. Email, phone, city, then the portfolio address: jordan.ellis@example.com · +1 555 0100 · Chicago, IL · jordan-ellis.example.com. It's the first place anyone looks for contact details, whether a person or a program.
  2. Write it out, then make it clickable. Leave off https:// and www. to keep it short; a typed address still works in any browser. Then select the text and add the link, so the visible words and the target are the same address.
  3. Add a label if your contact line is busy. "Portfolio: yourname.com" tells both a person and a program what the address is.
  4. Keep it in the body. In Word or Google Docs, type the contact line as the first paragraph of the page, not in the header area, and not in a text box or shape.
  5. Project links stay short or stay hidden. If a project has its own case study, either write a short path that fits on one line (yourname.com/checkout) or put the link on the project name and rely on the address at the top for the readers that only take text. Don't let a long address wrap.
  6. LinkedIn and GitHub follow the same rule. Written out after the portfolio, for example linkedin.com/in/yourname, so they survive the same readers.

The Copy-Paste Test

You can check your own file in a minute without any tool. Open the exported PDF, select all the text, copy it and paste it into a plain-text editor. Search for your address. If it is there in one piece, a text reader will find it. If you see "Portfolio" with no address, a broken address, or no contact line at all, fix the file. Then click the link in the PDF itself to check that it opens the right page.


Export the PDF So the Link Still Works


One Page Resume or Two?

The one page resume is a convention more than a rule. In our index, only 56 postings from 27 employers state a page count for the resume: 36 of those postings say one page, 17 allow up to two, 3 allow three or more. One employer's postings even say the opposite, asking candidates not to feel obliged to stop at one page. Everywhere else, length is your call.

One page is the safe default for students and early-career applicants: there is rarely enough relevant work to fill two, and a reviewer reads the top third first. A second page is fine when it holds relevant experience, for example several roles in the field you're applying to. The portfolio link is what lets you stay at one page: the case studies, screenshots and code live on the site, and the resume only has to make the reader want to open it.

The clearest exception is US federal hiring. Since September 27, 2025, USAJOBS limits all resumes to two pages, and the Office of Personnel Management's guidance to agencies is blunt:

"Agencies should only review resumes from job seekers that are 2 pages or less."
— U.S. Office of Personnel Management, Agency Guidance on the Two-Page Limit on Resume Length

A federal application then has a hard limit, and a portfolio link is the place for everything that doesn't fit.


The One-Page PDF Portfolio, for Forms That Want a File

Some application forms have a portfolio upload field and no place for a link. That is when a PDF portfolio makes sense, and it should do the same job as the resume link: send the reader to the live site. Design is where this comes up most: about 2 in 100 design postings ask for a portfolio link outright, against roughly 1 in 900 postings overall once one employer's template is set aside. One page is enough:

Part of the pageWhat goes in it
Top bandYour name, the role you're applying for, and the portfolio address written out and linked
Two or three project blocksOne small image each, a one-line problem, a one-line result with a number if you have one, and a short link to the full case study
Bottom line"Full portfolio and more projects: yourname.com", written out again

The same rules from the test apply: every address written out as text, nothing important inside an image, no address long enough to wrap. Choose the two or three projects that fit the posting, and keep the images small so the file stays light; portal limits vary, and the Handshake guide covers the strictest common one. For role-specific advice on a portfolio PDF, see the data science portfolio PDF section of our data scientist example.


How Many Resumes Already Carry a Link?

We counted, in aggregate, which links the resumes behind the 1,016 portfolios on Seera contained. Because owners can edit afterwards, these are upper bounds for what the resumes held.

Link on the resumeAll (1,016)Software and data roles (399)Other roles, design excluded (566)
LinkedIn64%83%51%
Personal website or portfolio22%27%17%
GitHub32%67%9%
A link on at least one project23%40%12%
Anything that shows work (site, GitHub or project link)47%76%26%
No link at all28%10%41%

LinkedIn is the default link; a personal site is not. In roles outside software, data and design, about 3 in 4 resumes had nothing a reviewer could click to see the work itself. (Design had too few resumes, 49, for its own column.) That gap is the cheapest one to close on a resume: one address in the contact line.


Doing This With Seera

Upload a PDF or Word resume and Seera turns it into a portfolio website in about a minute. It covers the parts of this guide a document can't:

For the portfolio side of the same question, see how to add your portfolio link to LinkedIn and how to check your resume against a live job posting.

Find the jobs worth sending your resume to →


Frequently Asked Questions

Should I put my portfolio link on my resume?

Yes, if the portfolio shows work that backs up the resume. Put it in the contact line under your name, written out as text and clickable. Few job postings ask for it in so many words, but a resume reviewer can only open a portfolio they can find, and of the 1,016 resumes behind portfolios on Seera, 64% listed LinkedIn while only 22% listed a personal website.

Where should the portfolio link go on a one-page resume?

In the contact line at the top, after your email and phone, written out without https:// (for example yourname.com). Keep it in the body of the page, not in a Word header, footer or text box, and not only behind an icon or the word Portfolio. In our test those placements lost the address in at least one reader.

Can an ATS read hyperlinks in a PDF resume?

It depends on the reader: some read link targets, others only the visible text, and we didn't test commercial systems. In our test, two text-only readers dropped an address hidden behind the word Portfolio or an icon, while a reader that also reads link targets kept it. Writing the address out as visible text works for both kinds.

Should a resume be one page?

One page is the safe default for students and early-career applicants, and a second page is fine when it holds relevant experience, unless the posting sets a limit. Few do: in our index, 56 postings from 27 employers state a page count, most of them one page. US federal jobs on USAJOBS cap resumes at two pages.

What should a one-page PDF portfolio include?

Your name, role and portfolio address at the top, then two or three projects, each with one small image, a one-line problem, a one-line result and a short link to the full case study. Send it only when an application form wants a portfolio file; otherwise put the live link on your resume.


Useful sources and further reading

About the author

Ahmed Hussein — Founder of Seera · Software Development Engineer at Amazon

Ahmed is the founder of Seera and a Software Development Engineer at Amazon. He builds the AI that turns resumes into portfolio websites and writes about how resumes, portfolios and job matching actually work.

Reviewed by Mazen Ahmed, Co-founder & Growth Product Manager at Seera.

Editorial standards →