Skip to content

CMS Media Library

The CMS Media Library manages all media files used in your content - images, documents, videos, and more.

Overview

Upload, organize, and manage media files that can be used across all content types. The library provides a central repository for all CMS assets.

Page Layout

  • Upload button - Add new files
  • Create Folder - Organize files
  • Search - Find files
  • Filter - Filter by type, date
  • View Toggle - Grid or list view
  • Files Display - Show uploaded files

Supported File Types

CategoryExtensions
Imagesjpg, png, gif, webp, svg
Documentspdf, doc, docx, xls, xlsx
Videosmp4, webm, mov
Audiomp3, wav, ogg

Common Tasks

Uploading Files

  1. Click Upload
  2. Select files from computer
  3. Or drag and drop files
  4. Wait for upload to complete
  5. Files appear in library

Creating Folders

  1. Click Create Folder
  2. Enter folder name
  3. Click Create
  4. Move files into folder

Using Media in Content

  1. Open content entry
  2. Click media field
  3. Select from library or upload new
  4. Insert into content

Editing File Details

  1. Click on file
  2. View/edit metadata:
    • Name
    • Alt text (for images)
    • Caption
  3. Save changes

Replacing Files

  1. Click on file
  2. Click Replace
  3. Upload new file
  4. Original links update automatically

Deleting Files

  1. Select file(s)
  2. Click Delete
  3. Confirm deletion

Warning: Deleting files removes them from all content using them.

File Information

For each file, you can see:

  • Filename
  • Type
  • Size
  • Dimensions (for images)
  • Upload date
  • Used in (linked content)

Organization Tips

Folder Structure

Media Library/
├── Images/
│   ├── Blog/
│   ├── Products/
│   └── Team/
├── Documents/
│   ├── Downloads/
│   └── Policies/
└── Videos/

Naming Convention

  • Use descriptive names
  • Include dates if relevant
  • Avoid spaces (use hyphens)
  • Example: product-hero-image-2024.jpg

Image Best Practices

  • Web Format - Use jpg for photos, png for graphics
  • Optimize Size - Compress before upload
  • Alt Text - Always add for accessibility
  • Consistent Dimensions - Maintain aspect ratios

Tips

  • Organize Early - Create folders before uploading
  • Alt Text - Add to all images
  • Check Usage - See where files are used
  • Clean Up - Remove unused files periodically
  • Backup - Keep copies of important files

💡 Note: Well-organized media makes content creation faster and more efficient.

Released under the MIT License.