A size, format, and image-role guide for freelancers preparing Upwork portfolio items and Project Catalog gallery files.
The right Upwork image export depends on the role. A Project Catalog gallery image, portfolio thumbnail, UI screenshot, service process diagram, PDF work sample cover, and optional video thumbnail do not all need the same file treatment.
One universal export can make a mockup look fine but a dashboard unreadable. The goal is to choose a format that protects the proof the client needs to understand.
Start with the image role, then choose JPG or PNG
JPG is often practical for photographic previews, rich mockups, presentation covers, and portfolio visuals with gradients or real-world imagery. PNG is often safer for UI screenshots, dashboards, charts, icons, owned logos, flat graphics, diagrams, and typography-heavy samples where crisp edges matter.
Use JPG when
The image is a mockup, photo-style preview, presentation cover, or rich visual where small compression artifacts are not distracting.
Use PNG when
The image contains UI text, dashboard labels, vector-like shapes, flat colors, owned logo edges, or a process diagram.
Upwork image role decision table
| Upwork image role | What it should communicate | Best format/export logic | Review risk | What to preview |
|---|---|---|---|---|
| Project Catalog cover or gallery image | The service offer and visual style of the deliverable. | JPEG or PNG, 4:3, sharp around 1000 × 750, under current Upwork limits. | Low-quality image, clickbait claim, contact information, unauthorized logo, poor crop. | Does the thumbnail explain the package without zooming? |
| Service proof screenshot | A readable piece of the actual work result. | PNG when text/UI must stay crisp; JPG only if the preview remains readable. | Private data, account identifiers, blurred labels, over-compression. | Can the client read the key proof on desktop and mobile? |
| Portfolio case-study image | Context, before/after logic when accurate, or final deliverable quality. | Use a clean 4:3-friendly crop; keep source files separate. | Misleading claims, private work without permission, too much text. | Does it support the profile niche and service category? |
| Process or workflow visual | How you work without exposing confidential details. | PNG is usually safer for labels and simple shapes. | Client names, internal documents, platform screenshots used without rights. | Can someone understand the process in five seconds? |
| PDF work sample cover | The topic of the attached sample or case study. | Prepare separately from gallery images; avoid tiny table screenshots. | Trying to compress a whole document into one crowded image. | Does the cover invite the reader to open the sample? |
| Optional video thumbnail | A professional preview of the service video where supported. | Use the current Project Catalog video and thumbnail screen requirements. | Clickbait title, contact info, low-resolution visuals, logos you do not own. | Does the video preview match the same service promise? |
Why PDF work samples should be prepared separately
A PDF work sample often needs multiple pages, a cover, and enough context to explain the project. A Project Catalog gallery image needs fast visual clarity. A portfolio thumbnail needs a strong first impression. Trying to make one export serve all three usually creates a crowded, soft, or confusing result.
Keep your source files, high-quality export, PDF cover, and upload delivery copy in separate folders. That way you can update one Upwork preview without destroying the original case study.
Format choices must include privacy and rights
Choosing PNG for a dashboard does not make it safe to publish. Remove private client data, names, emails, analytics IDs, account balances, support tickets, login screens, and anything you do not have permission to show. If a logo, brand mark, or third-party interface is not yours to display, use a neutral placeholder or an example you created.
Make one tested delivery copy
After choosing the role and format, export one sample, preview it, and inspect the actual details: title readability, crop, proof area, text density, and file weight. Only then should you repeat the export for similar work samples.
FAQs About Upwork JPG, PNG, and Portfolio Size
It depends on the content. JPG is practical for rich visuals and mockups. PNG is safer for UI screenshots, charts, diagrams, and text-heavy details that must stay crisp.
Upwork currently recommends 1000px by 750px for portfolio images, with 400px by 300px minimum and 4000px by 4000px maximum. Always verify the live upload screen.
No. Keep source files separately and upload a clean delivery copy that removes private information and matches the preview role.
