Media

Media is the images, documents, and other files you use on your sites. You upload a file once and can reference it from any page in the workspace, since media lives at the workspace level rather than per site.

To upload programmatically, see the media API.

Uploading

Upload files from the Media page or drop them straight into the page editor. In Markdown, you reference an uploaded file by its URL like any image or link:

![A sunset over the bay](/media/.../sunset.webp)

Download the [full album](/media/.../album.zip).

You can organize files into folders, and for photos, order galleries by the date they were taken.

How files are processed

Uploads are processed automatically so your site stays fast:

  • Images (JPEG, PNG, GIF, WebP) are converted to WebP, which keeps quality high while making pages load quickly. Images are not resized. They keep their original dimensions.
  • Metadata such as EXIF data and GPS location is stripped from images, videos, and PDFs. You can turn this off per upload if you want to keep it.
  • MOV videos are transcoded to MP4 for web playback.

Supported file types

Images: JPEG, PNG, GIF, WebP. Documents: PDF, Word, Excel, PowerPoint, plain text, CSV, Markdown. Archives: ZIP. Audio: MP3. Video: MP4, WebM, MOV.

Both the file extension and the actual contents are checked; a file whose contents don’t match its extension is rejected. SVG is not accepted.

Storage and size limits

The Free plan includes 1 GB of storage with a 10 MB limit per file. Pro includes 15 GB with a 10 GB limit per file, and you can purchase additional storage. The dashboard shows how much you have used; delete files you no longer need to free up space.

Galleries

Pages with multiple images can render them as a gallery. Theme settings control the layout (including masonry and full-width options), and you can offer visitors a “Download all” button that serves the gallery as a ZIP.

Protected media

Media is protected when the page it belongs to is password-protected, or when the whole site is. There is no separate per-file password. Protect the page or the site instead. See Password protection.