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
- Click Media Library in the left sidebar
- Click the Upload assets button
- Drag and drop files, or click to browse
- Files are available immediately after upload
From a Content Field
When editing a course or lesson, you can upload directly from media fields:
- Click the image/media field
- Choose Upload new or Browse existing
- Select or upload your file
- 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
- Select the file(s) you want to delete
- Click the delete button
- 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"