Uploading images
The media library is where all images and videos on your site live. Uploading a file adds it to your library so you can place it in any Media section — or swap it in later without re-uploading.
How to open the upload area
Section titled “How to open the upload area”Open the media library from any Media section in the editor. The upload area appears at the top of the panel that slides open.
Uploading a file
Section titled “Uploading a file”You have two options:
- Drag and drop — drag one or more files from your desktop and drop them onto the dashed upload zone.
- Click to browse — click anywhere in the upload zone to open a file picker and select files from your computer.
Both accept images (JPEG, PNG, WebP, GIF, and most other common formats) and video files.
What happens after you drop a file
Section titled “What happens after you drop a file”Your browser processes the file immediately — no waiting for a server round-trip:
- The image is converted to WebP format in your browser.
- Three sizes are generated automatically: 640 px, 1 080 px, and 1 920 px wide. The right size is served to each visitor depending on their screen, so pages stay fast.
- The processed file is held locally until you save. Once you save, it is stored in your site’s GitHub repository.
After processing finishes, the image appears in the library grid below the upload zone.
File size limit
Section titled “File size limit”Files larger than 5 MB are rejected and will not upload. If a file is too large, you’ll see a notice — for a single over-limit file it names the file; if several are rejected at once, it shows how many. Compress or resize the image first, then try again.
(This limit is a default and can be adjusted by your site administrator.)
Alt text
Section titled “Alt text”Each image in the library has an alt text field directly below its thumbnail. Alt text describes the image for screen readers and search engines. Fill it in after uploading — you can update it at any time from the library.