Putting a portfolio link on a résumé so it survives the file

A portfolio link on a résumé passes through a text extractor before a human sees it. What comes out the other side decides whether anybody visits.

ConxfolioPublished 2026-09-12

— it has to survive being turned back into text.

A portfolio link is the one piece of a résumé whose job is to be typed or clicked by somebody else, which makes it the piece most exposed to what happens between your file and their screen. Most of the time that is a text extractor, and extractors treat a link as a run of characters like any other.

Where it goes

In the header, beside the email address and phone number, in the body of the first page. Not in the page header furniture, because contact details placed there are often skipped entirely by extraction, which is one of the faults the ATS format page covers. Not at the bottom under a heading called Links, where it sits below the fold of a ten-second read.

One line is enough. Your name, an email address, a phone number, a city, and the address of your page. The header page has the rest of that block.

Write the address as the visible text

A hyperlink whose visible text says "Portfolio" is a hyperlink that disappears completely when the file is turned back into text: the extraction returns the word and loses the destination. Writing the address itself as the visible text means the address survives in both forms, as a clickable link for a person and as characters for a parser.

This also helps the reader who prints the page, which still happens more often than people expect at the interview end of the process.

Why a short handle matters here

A long address wraps. A wrapped address is returned by extraction with a line break in the middle, sometimes with a hyphen added by the layout, and what a reader copies then does not resolve. The defence is to keep the whole thing short enough to sit on one line in a narrow column.

Publishing on this site claims an address of the form the domain followed by the handle you type, and the sheet states the rules: lower-case letters, digits and dashes, between 3 and 63 characters. Staying well under that limit is the useful discipline, and choosing the address covers the rest of the decision, including the test of saying it out loud.

Check that it survived

This is the part almost nobody does and it takes a minute. Run the file you are actually going to send through the ATS résumé checker. The report prints what the extraction read out of your document, including the word count and the recognised headings, so you can see whether the header came back whole or arrived as fragments.

The checker needs no job description and no account, and it reads the résumé on its own. It is not an employer's applicant tracking system and it does not predict anything; it reports what a parser got out of your file, which is exactly the question here.

One link, not four

A header carrying a portfolio, a code repository, a professional network profile and a personal site is a header that has stopped being a header. Pick the one you want visited. If the page you publish carries the others in its own contact section, which it does when you fill those fields, the résumé only ever needs to point at the page.

That is a real advantage of having a page at all: it gives you one address to give out instead of four, and you can change what is behind it without reissuing the document.

Keep the two in agreement

If the résumé says one thing and the page says another, a reader believes neither. The most common version of this is a title: the résumé calls you one thing and the page calls you another, because they were written eight months apart. Checking them side by side before sending is the same ten seconds that catches a mismatched email address, and it is worth spending.

And in the letter

Once, in the header, if the letter's header carries contact details. A cover letter that repeats the address in the closing paragraph is repeating itself, and the letter has better uses for that line, as the header and date page sets out.

What happens to the link in a DOCX

A DOCX carries hyperlinks as part of the document structure, and most systems that read one preserve them. A PDF is less predictable: some exporters write the link as an annotation that sits over the text rather than in it, so the extraction returns the visible characters and loses the destination entirely.

That is the practical reason to write the address itself as the visible text rather than hiding it behind a word. It costs a few characters of line width and it means the same information survives both export paths and a printer. File names and formats covers the wider choice between the two formats.