How many portfolio pieces should I attach to a proposal?

Usually one, the piece most relevant to that specific job. Attaching everything forces the client to hunt for relevance and weakens your pitch. A single well-matched sample, clearly framed, is more persuasive than a large gallery.

What if my best work is not relevant to the job?

Choose relevance over polish. A sample that matches the client's exact task, even if it looks less impressive, connects more directly to their need. If nothing fits, build a quick sample that mirrors the job.

Should I attach files or use links?

Either works, but make it easy and safe. Ensure links open to the right piece and files are professional and simple to view. Keep sharing inside Upwork so you stay protected and the client can access it without friction.

Can I use practice work as a portfolio piece?

Yes. A sample built to look like a real deliverable is valid proof, often more relevant than old, unrelated client work. Present it confidently and frame why it demonstrates you can do the client's specific job.

Do I need to explain the portfolio piece?

Yes. Do not just paste a link. Tell the client what to notice and why it relates to their project. Framing turns a passive sample into active persuasion and connects your proof directly to the outcome they want.

Where should my portfolio live on Upwork?

Keep a strong portfolio on your profile, since clients check it, and point to the single most relevant piece inside each proposal. Use the proposal to guide them to the right work rather than making them search.

Proposals & cover letters

How to Attach a Portfolio to an Upwork Proposal

7 minute readUpdated June 2026Explore more

TL;DR

Attaching a portfolio is easy; choosing the right piece is what matters. Show the one sample closest to their job and tell the client why it is relevant.

Proof is one of the strongest things a proposal can carry, but only if it is the right proof. A portfolio dump of everything you have ever made actually weakens your pitch, because it forces the client to hunt for relevance. The skill is not attaching work; it is choosing and framing the single most relevant piece for this specific job.

Where portfolio work lives

You can showcase work in a few places: items in your profile portfolio, attachments on a proposal, and links inside your proposal text. Keep your profile portfolio strong since clients check it, and use the proposal itself to point them to the one piece that matches their job. Do not make them dig.

Choose relevance over your favorite

Pick the sample closest to the client's exact task, even if it is not your best-looking
Match the format, industry, or outcome they described in the post
One highly relevant piece beats five impressive but unrelated ones

Always frame the proof

Do not just paste a link and hope. Tell the client what to notice. "Here is a landing page I built for a similar product; notice how the top section leads straight to a single action, which is what I would do for you." Framing turns a passive sample into active persuasion that connects to their goal.

If you have no client work yet

Build a sample that mirrors the exact kind of job you are applying for and treat it as portfolio proof. A practice piece created to look like a real deliverable is completely valid and often more relevant than old, unrelated work. Show it with the same confidence you would show a paid project.

Keep links clean and safe

1Make sure any link actually works and opens to the right piece
2Keep files professional and easy to open
3Keep the conversation and sharing inside Upwork to stay protected

Common questions

How many portfolio pieces should I attach to a proposal?
Usually one, the piece most relevant to that specific job. Attaching everything forces the client to hunt for relevance and weakens your pitch. A single well-matched sample, clearly framed, is more persuasive than a large gallery.
What if my best work is not relevant to the job?
Choose relevance over polish. A sample that matches the client's exact task, even if it looks less impressive, connects more directly to their need. If nothing fits, build a quick sample that mirrors the job.
Should I attach files or use links?
Either works, but make it easy and safe. Ensure links open to the right piece and files are professional and simple to view. Keep sharing inside Upwork so you stay protected and the client can access it without friction.
Can I use practice work as a portfolio piece?
Yes. A sample built to look like a real deliverable is valid proof, often more relevant than old, unrelated client work. Present it confidently and frame why it demonstrates you can do the client's specific job.
Do I need to explain the portfolio piece?
Yes. Do not just paste a link. Tell the client what to notice and why it relates to their project. Framing turns a passive sample into active persuasion and connects your proof directly to the outcome they want.
Where should my portfolio live on Upwork?
Keep a strong portfolio on your profile, since clients check it, and point to the single most relevant piece inside each proposal. Use the proposal to guide them to the right work rather than making them search.

Keep going

Want to build a portfolio that wins jobs even with no reviews yet?

Get the other 15 in the proposal stack, plus the full Upwork Income Club community - $9/mo, cancel anytime.

Join the Club