Media Library
Search, review, edit, and remove uploaded images and videos used across your organization.
Use Content > Media Library to manage uploaded images and videos for your organization. Media Library is for assets used by page builders, details pages, branding surfaces, and other visual editors.
Use Resource Library instead when learners need a downloadable document or external link.
Before you begin
You need admin access to organization media.
Before changing media, check:
- Whether the asset is used on a page, course, event, or other surface.
- Whether the filename is clear enough for admins.
- Whether image alt text is present and useful.
- Whether deleting the asset would break a learner-facing page.
Find media
Open Media Library
- Open Admin Dashboard.
- Go to Content > Media Library.
The library table shows:
| Column | Meaning |
|---|---|
| Preview | Thumbnail for images or media type preview for videos. |
| Filename | Stored filename and alt text. |
| Type | Image, video, or MIME type. |
| Size | File size. |
| Updated | Relative last updated time. |
| Actions | Edit details or delete. |
Search media
- Enter text in Search by filename or alt text.
- Press Enter or select Search.
Search checks filename and alt text. It does not search inside the image or video content.
Filter by type
Use the Type selector:
- All
- Images
- Videos
The type filter resets pagination to the first page.
Change rows per page
Use Rows per page to show:
- 10 rows.
- 20 rows.
- 50 rows.
- 100 rows.
Use the pagination controls to move to first, previous, next, or last page.
Review and update media
Review media details
Select a media row or the edit action.
The detail dialog shows:
- Image or video preview.
- MIME type.
- File size.
- Updated time.
- Filename.
- Alt text.
- Usage list.
- Delete and Save changes actions.
For videos, the preview includes video controls.
Edit filename and alt text
- Open a media item.
- Edit Filename.
- Edit Alt text.
- Select Save changes.
Use alt text to describe the image for learners who use assistive technology or for cases where the image does not load. For decorative images, keep the alt text short and avoid stuffing keywords.
Delete safely
Check usage before deleting
The detail dialog includes a Usage section.
Usage can show:
- Entity type.
- Entity ID.
- Field path.
- When that usage was recorded.
If usage is empty, the dialog shows Not used in any page or course.
Check usage before deleting so you do not remove an asset that still appears on learner-facing pages.
Delete media
- Open the media item.
- Select Delete.
- Confirm Delete this media?.
Built LMS blocks deletion when the media is still referenced. If deletion is blocked, remove or replace the media from the listed pages or courses first, then try again.
Deleting removes the file and its media record.
Recommended naming pattern
Use filenames that help future admins understand the asset:
- Include program or page context.
- Include the asset purpose.
- Avoid personal desktop filenames such as
Screenshot 2026-06-01. - Avoid version clutter unless the version matters.
Examples:
manager-onboarding-hero.jpgcourse-catalog-banner.mp4compliance-certificate-background.png
When to replace instead of delete
Replace the asset on the page, course, event, or template when learners still need that surface but the image or video is outdated.
Use deletion only when:
- The asset has no usage records.
- The asset is duplicated and the duplicate is already removed from pages.
- The asset contains outdated, incorrect, or sensitive content that should not remain available.
- A replacement has already been saved everywhere the asset was used.
Verify and support media
Verify success
After updating media:
- Search finds the item by filename or alt text.
- Preview loads.
- Filename is readable.
- Alt text is accurate.
- Usage list is understood before deletion.
- Learner-facing pages still render correctly.
Troubleshooting
Check search, type filter, page number, and whether the organization has any uploaded media.
The media is still referenced. Open the usage list, remove the asset from those locations, save those pages or courses, and try again.
Check the media item, then check the page or details page block that uses it. The issue may be the block crop, aspect ratio, or selected image rather than the media record.
Search by filename or alt text. If neither contains the term, open the likely page or editor and inspect the selected media from there.