Image sizes, formats and quality

Which image formats and pixel sizes each plan accepts, how FolioPage optimises uploads, and how to prepare photos so they look sharp and load fast.

On this page
  1. Limits per plan
  2. What happens after you upload
  3. Preparing photos before you upload
  4. Alt text

Big, sharp photos are the point of a portfolio, but oversized files make pages slow. FolioPage keeps your original upload untouched and creates an optimised copy for the places where a smaller image is enough, so you get both quality and speed. This article explains the limits and what happens to an image after you upload it.

Limits per plan

Free Pro Max
Image formats JPEG, PNG, WebP, GIF, SVG JPEG, PNG, WebP, GIF, SVG JPEG, PNG, WebP, GIF, SVG
Other files - - PDF, MP4, WebM
Maximum size per file 5 MB 20 MB 50 MB
Maximum width or height 2,000 px 4,000 px 8,000 px
Total storage 100 MB 2 GB 10 GB

The pixel limit applies to the longer side of the image. An upload that is larger than your plan allows fails with a message saying which limit it exceeded, and it does not count against your storage. Limits are checked per site and shown on the Plan & Usage page.

What happens after you upload

For JPEG, PNG, WebP and GIF files, FolioPage:

  1. Keeps the original file exactly as you uploaded it. It is never resized or recompressed.
  2. Creates an optimised copy in WebP format, scaled down so its longer side is at most 800 px. Smaller images are not enlarged.

The optimised copy is used where a medium-sized image is all the visitor sees: page sections, thumbnails in the media library and portfolio listing grids. The original is used where full quality matters: the main image and lightbox on a portfolio item's page, and the Open Full View and Copy URL actions in File details.

SVG files are not converted. They are cleaned of any embedded scripts for your visitors' safety and then served as they are. PDF and video files (Max plan) are stored without any processing.

Note: Storage is counted on the original file size. Uploading a 12 MB JPEG uses 12 MB of your allowance even though a much smaller copy is served in most places.

Preparing photos before you upload

A few habits keep your site fast without any visible loss of quality:

  • Export at a sensible size. For most portfolio work, 2,000 to 2,500 px on the long side is plenty for a full-width image on a large screen. Exporting at full camera resolution only uses up storage.
  • Prefer JPEG or WebP for photos. PNG is best for graphics with flat colour or transparency; for photographs it produces files many times larger.
  • Use SVG for logos and icons. An SVG stays crisp at any size and is usually only a few kilobytes.
  • Avoid animated GIFs in page sections. The optimised copy of a GIF is a still image of its first frame, so the animation plays only where the original file is shown.
  • Name files clearly before uploading, for example studio-portrait-01.jpg rather than IMG_4821.jpg. You can rename a file later in File details, and the name helps when searching the library.

Alt text

Open any image's File details and fill in Alt text with a short, plain description, such as Bride and groom walking along a beach at sunset. Screen readers read it aloud, search engines use it to understand the image, and it is shown if the image cannot load.

Tip: If an image looks soft in a page section, the cause is usually a small source file rather than the optimisation. Check the Dimensions shown in File details; if the original is under 800 px wide, re-export it at a larger size and upload again.

Related articles