Site Building

Customize the Drupal Media Library Browser Widget for Drupal 8, 9, and 10

When using the Drupal Media Library to browse for available Media entities to attach to your content, the interface that you see inside the modal window is created using Views. This means you can change it for your specific use-case. This is most useful when you want to expose filters for custom fields to allow users to more easily locate content in your library. As your library of media grows, you can create powerful application-specific ways for content authors to segment the list and find their assets.

In this tutorial we'll:

  • Learn how to edit the Views used by the Drupal Media Library browser
  • Add a new exposed filter for the custom tags field on some media entities
  • Demonstrate how this change affects the user interface for locating and selecting media

By the end of this tutorial you should be able to customize the View used by the Media Library to add new filters and make other use-case specific changes.