Assets & Media Manager
Upload, browse, organize, and reuse images across your spaces.
Overview
The Assets page gives you a central place to manage all your uploaded images. Every image you upload — whether through the editor, as a cover image, or as an avatar — is tracked here with its metadata, folder, and usage information.
Navigate to the Assets page from the sidebar to get started.
Uploading Images
Drag and drop images onto the upload zone, or click to browse your files. Supported formats: JPEG, PNG, GIF, and WebP. Maximum file size is 3 MB per image.
Uploaded images are automatically organized into folders based on where they were uploaded (e.g., images for editor uploads, covers for cover images).
Browsing & Searching
Switch between grid and list views to browse your assets. Use the search bar to filter by filename or file type.
Filter by folder using the folder dropdown to see only images in a specific category.
Custom Folders
Create your own folders to organize images beyond the built-in categories (images, covers, avatars). Select images and use the Move to folder action to reorganize them, or create a new folder on the fly.
Bulk Operations
Select multiple images using the checkboxes, then use the toolbar that appears at the bottom of the screen:
- Move to folder — Reorganize selected images into a different folder
- Promote to global — Make selected images available across all your spaces
- Delete — Remove selected images (with a warning if any are currently used in entries)
Global Assets
Images are scoped to the space where they were uploaded. To reuse an image across spaces, promote it to global — this creates a shared copy that any space can import.
Switch to the Global tab in the assets page to browse your global images and import them into the current space.
Reference Tracking
Swashbuckler automatically tracks which entries use each image. When you try to delete an image that's referenced in an entry (as inline content or a cover image), you'll see a warning showing how many entries would be affected.
Storage Stats
The assets page shows your storage usage — total file count, total size, and a per-folder breakdown — so you can keep track of how much space your images are using.