Media Library

The Media Library stores all the images and files that appear in your content. Instead of uploading the same image multiple times in different editors, you upload it once and reference it from anywhere. This keeps file storage efficient and makes it easy to update an image across many pages.

Browsing Media

The Media Library shows all uploaded files in a grid or list view. You can filter and search to find what you need.

Key fields shown per file:

• Preview: Thumbnail for images, file icon for other types.
• Filename: The original uploaded file name.
• Type: Image, video, document, or other.
• Size: File size in KB or MB.
• Uploaded by: Who uploaded the file.
• Uploaded at: When the file was uploaded.
• Alt text: The accessibility description for images.

Filtering and search:

• Filter by file type (images, documents, video).
• Search by filename or alt text.
• Sort by date, name, or size.

Uploading Files

Click Upload or drag files directly onto the media grid to upload.

Supported file types:

• Images: JPG, PNG, GIF, WebP, SVG, AVIF
• Documents: PDF
• Video: MP4, WebM (for embedded video — not for streaming)

File size limits:

• Images: up to 10 MB
• Documents: up to 25 MB
• Video: up to 100 MB

Tips:

• Compress images before uploading. Large images slow down page loads.
• Use WebP format for the best quality-to-file-size ratio.
• Name files descriptively before uploading — filenames are used in the generated URL.

Alt Text

Alt text is the text description of an image used by screen readers and search engines. It appears when an image fails to load and is indexed by search engines.

Why it matters:

• Accessibility: Screen reader users depend on alt text to understand image content.
• SEO: Descriptive alt text helps search engines understand and index your images.
• Performance fallback: Alt text is displayed when images cannot load.

Tips:

• Write alt text as a brief, descriptive sentence. Describe what the image shows, not what it represents.
• Do not start alt text with "Image of" or "Photo of" — screen readers already announce it as an image.
• For decorative images with no informational content, use an empty alt attribute.

Inserting Media in the Editor

From the content editor, use the image button in the toolbar or the media picker to insert files from the library.

When inserting an image:

1. Click the image icon in the editor toolbar.
2. Choose From Library to browse the Media Library.
3. Select the file and click Insert.
4. Optionally resize or align the image within the editor.

The alt text stored on the media file is automatically used when inserting. You can override it for a specific use in the editor.

Deleting Media

Select files and click Delete to remove them from the library.

Important: Deleting a media file removes it permanently. Any content that references the deleted file will show a broken image. Check where a file is used before deleting.

Tips:

• Use the filter by type to find unused images before bulk deleting.
• If a file is embedded in published content, archive the content before deleting the media.