Built LMS Help Center
Content

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

  1. Open Admin Dashboard.
  2. Go to Content > Media Library.

The library table shows:

ColumnMeaning
PreviewThumbnail for images or media type preview for videos.
FilenameStored filename and alt text.
TypeImage, video, or MIME type.
SizeFile size.
UpdatedRelative last updated time.
ActionsEdit details or delete.

Search media

  1. Enter text in Search by filename or alt text.
  2. 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

  1. Open a media item.
  2. Edit Filename.
  3. Edit Alt text.
  4. 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

  1. Open the media item.
  2. Select Delete.
  3. 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.

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.jpg
  • course-catalog-banner.mp4
  • compliance-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:

  1. Search finds the item by filename or alt text.
  2. Preview loads.
  3. Filename is readable.
  4. Alt text is accurate.
  5. Usage list is understood before deletion.
  6. Learner-facing pages still render correctly.

Troubleshooting

On this page