Media Library

How to upload and manage images and files in Strapi.

The Media Library

The Media Library is where all uploaded files are stored and managed. This includes course thumbnails, images embedded in lesson content, and any other uploaded files.

Uploading Files

From the Media Library

  1. Click Media Library in the left sidebar
  2. Click the Upload assets button
  3. Drag and drop files, or click to browse
  4. Files are available immediately after upload

From a Content Field

When editing a course or lesson, you can upload directly from media fields:

  1. Click the image/media field
  2. Choose Upload new or Browse existing
  3. Select or upload your file
  4. The file is saved to the Media Library automatically

Managing Files

Browsing

  • Use the search bar to find files by name
  • Use filters to narrow by file type (images, videos, documents)
  • Switch between grid and list view

Organizing

  • Files can be organized into folders
  • Create folders for different courses to keep things organized
  • Example structure:
    • course-thumbnails/
    • lesson-images/data-analytics/
    • lesson-images/python-ml/

Deleting Files

  1. Select the file(s) you want to delete
  2. Click the delete button
  3. Confirm the deletion

Be careful when deleting files that are currently used in published content. Deleting a file will remove it from any content that references it.

Image Best Practices

  • Course thumbnails: 1200x630px, JPG or PNG, under 2MB
  • Lesson images: Optimize for web — keep file sizes reasonable
  • Use descriptive names: "data-analytics-dashboard.png" is better than "IMG_4532.png"