Media
Images and files live in the site media library. Editors pick them through the media picker when editing image, image_list, richtext embeds, and similar fields.
Media picker
In Edit mode, open a field that needs a file:
- Use the picker to choose an existing upload or Upload… a new one.
- Confirm — the field stores the public URL/path.
- Delete on a library item removes the file from the media library (confirm first). This cannot be undone from the picker.
Upload goes through POST /admin/media/upload. Delete uses Toolbox delete_media.
image_list: remove ≠ delete
An image list field holds an ordered list of URLs.
| Action | Effect |
|---|---|
| Remove an image from the list | Drops that URL from this field only — the file stays in the library |
| Delete in the media picker | Removes the file from the library (other fields may still reference a broken URL) |
Always prefer “remove from list” when you only want to rearrange a gallery. Use library Delete when you intend to discard the file itself.
Tips
- Prefer the picker over pasting opaque paths.
- After deleting a file, check other widgets that might still show it.
- ZIP SitePack backups include uploads; rolling checkpoints do not — see Checkpoint & backup.