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:
Download the [full album](/media/.../album.zip).
You can organize files into folders, and for photos, order galleries by the date they were taken.
What happens to your uploads
A file does not always come back the way you sent it, so expect these three changes.
- Images (JPEG, PNG, GIF, WebP) are converted to WebP at 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.
Every file is also stored under a generated name, so its URL will not match the filename you uploaded. The library still shows you the original name.
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 extension and the file’s contents have to be types on that list. A file whose extension disagrees with its contents, such as a .png holding JPEG bytes, is accepted as the image it really is. SVG is not accepted at all.
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 two separate settings control downloads. The “Download all” button serves the whole gallery as a ZIP, and it can sit under the page title or in the footer. Item downloads add a download button to each photo and video, shown on hover in the grid and inside the lightbox. Turning either one off also stops that kind of download on the server, so a visitor cannot reach it by URL.
Protected media
Media is protected when the page it belongs to is password-protected, or when the whole site is protected. There is no separate per-file password. Protect the page or the site instead. See Protection.