Managing your library

Every image and video you upload is stored in your media library. You can browse, search, reuse, and delete files from a single place.

Browsing your library

Open the full media library manager by clicking the Media library button (the image icon) in the editor toolbar at the top of the page. The library grid shows every file you’ve uploaded, with square thumbnails and the filename on hover.

Note: clicking an image inside a Media section opens a picker for choosing or swapping that section’s image — that is the insert/swap flow, not the full manager, so Delete, usage counts, and batch-select are not available there.

Use the search box to filter by filename, or use the type filter to show only images, animated files, or videos.

Reusing images across sections

An image you upload once can be placed in as many sections as you like — just select it from the library whenever you add or swap a Media section. Each section holds a reference to the image by its ID; the image file itself is stored once.

Usage counts

In the library’s manage view, hovering over a thumbnail shows a usage count — for example, “Used 3×” — so you can see at a glance which images are in use and which are not.

Deleting images

To delete one or more images:

1. Click the thumbnails you want to remove. A circle indicator appears on each selected item.
2. Click the Delete button that appears in the toolbar.
3. If any of the selected images are currently used in a section, a confirmation prompt appears. Confirming removes them from those sections and deletes the files.

Deletion takes effect in your working copy and is committed to your site’s repository when you save.

How images are served

Once published, your images are served through your site’s media route (/api/media/{id}/{width}.webp). The browser receives the size that best fits the visitor’s screen — 640 px, 1 080 px, or 1 920 px wide — rather than always downloading the largest version.

Images are cached at the CDN level so that each size variant is fetched from storage roughly once and delivered quickly on repeat visits.

Image IDs

Behind the scenes, every image has a 16-character ID derived from a hash of its contents. Two uploads of the same file produce the same ID, so the library will not store duplicates. You don’t need to work with IDs directly; they are used internally to wire sections to the right image.