Media Library
Last updated: March 2026
Upload, organize, and manage all your digital assets in one place. The media library handles images, documents, videos, and other files used across your pages, entities, and templates.
Uploading media
The media library accepts any file type: images (PNG, JPG, SVG, WebP), documents (PDF, DOCX), videos, and more. Files can be uploaded by dragging and dropping them onto the library, using the upload button, or through the media selection modal in the page builder.
The file upload service handles chunked uploads for large files, generates thumbnails for images, and stores metadata like file size, content type, and dimensions. Each uploaded file gets a unique URL that can be referenced from pages, entities, and templates.
Open the media library
Navigate to Designer > Media, or click the media icon in the page builder when inserting an image.
Upload files
Drag files onto the upload area or click "Upload" to browse. Multiple files can be uploaded simultaneously.
Organize and tag
After upload, click a file to edit its metadata: name, alt text, and description. These values are used for SEO when images are displayed on pages.
Storage limits depend on your plan: Free (20 MB), Light (1 GB), Essential (10 GB), Unlimited (100 GB). Monitor your usage in Settings > Subscription.
Managing assets
The media library provides a grid view of all uploaded files with search and filtering. You can edit file metadata, replace files, or delete unused assets. The edit modal lets you update the file name, alt text, and description without changing the file URL.
When selecting media in the page builder, a selection modal shows all available files with search. You can upload new files directly from this modal or choose from existing assets. Selected media is referenced by URL, so updating a file in the library automatically updates all pages that use it.
Usage tracking
The media usage modal shows where each file is used across your workspace: which pages reference the image, which entities use it as a field value, and which templates include it. This helps you understand the impact of deleting or replacing a file.
Before deleting a file, Webooto shows a confirmation dialog listing all places the file is currently used. This prevents accidentally breaking pages or templates by removing a referenced asset.
Deleting a media file is permanent. All references to it (in pages, entities, and templates) will show broken images. Always check the usage report before deleting.
Builder integration
The page builder integrates with the media library through the Media component and background image selectors. When you add a Media component to a page, you select an image from the library. Background images on any component (rows, grids, sections) also use the media selection modal.
Image fields in entities connect to the media library as well. When editing a record, clicking an image field opens the media selection modal where you can choose or upload a file. The selected image URL is stored in the entity record.