Managing Media in Drupal

Media management, the ability for content authors to upload and reuse multimedia assets via a common interface, is a cornerstone of any content management system. Many of the same principals we associate with written content apply to media such as structured data, revisions, editorial workflows, translations, and more.

The media management tools in Drupal, including the Media and Media Library modules, provide content authors with drag-and-drop media and asset handling, full WYSIWYG editor integration, and a library of reusable multimedia assets. There's minimal configuration required to get started, but full control via Drupal's standard Entity and Field systems for those who need it. Drupal separates different media assets into media types like image, file, and video, and then allows each media type to be displayed using an appropriate format. Display a PDF files as a link, and a video file as an embedded HTML5 video player. Contributed modules can add new media types and formatters.

In this series, you'll learn how to configure and use the Media and Media Library module's in Drupal core as well as related contributed modules. Throughout the series we'll look at the Media ecosystem from the perspective of a site administrator, content editors, themers, and developers.

Overview: Media Management in Drupal

Free

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Drupal's media management tools, the Media and Media Library modules, provide content authors with drag-and-drop media and asset handling, full WYSIWYG editor integration, and a library of reusable media assets. There's minimal configuration required to get started, but full control via Drupal's standard Entity and Field systems for those who need it.

In this tutorial we'll:

Overview: Media Types, Media Entities, and Media Fields in Drupal

Free

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Media entities are standard Drupal fieldable content entities. For the most part, they function, and are managed, in the same way as Nodes. So if you've previously created content in Drupal, much of working with Media entities should be familiar -- with some notable exceptions related to the connections between Media types and the media resources they represent.

In this tutorial we'll:

Add a Media Field to a Content Type in Drupal

Site Building, Theming, Site Administration, Drupal 10, Drupal 9, Drupal 8

More information

The most common way to use Drupal's Media items is to add fields to content types, allowing the Media entities to be associated with one or more pieces of content. For example, adding a cover image to an article, or embedding a set of YouTube videos into a tutorial. This is accomplished by adding a Media field to the content type in question.

In this tutorial we'll:

Find, Add, Edit, and Delete Media Entities in Drupal

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Media entities in Drupal are content entities, and can be administered like most other Drupal content entities. In most cases you'll likely add new Media entities via the Media Library widget when creating a new content entity like an Article. However, it's possible to add them to the library without having to attach them to a piece of content. You may also want to update an existing Media entity, or just search the library to see whether something already exists.

In this tutorial we'll:

Use Drupal Media Library to Browse Media Entities

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

The Drupal core Media Library module provides an enhanced user interface for locating Media entities and attaching them to an article. It's a drop-in replacement for the default entity reference widget which uses a not very intuitive autocomplete field. Using the Drupal core Media Library module requires minimal configuration.

How to Add a Media Button to a WYSIWYG Editor in Drupal

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

A commonly asked question is, "How do you add images to the body of a content item in Drupal?" You can allow users to embed images, videos, or any other media into a field configured with a WYSIWYG editor, such as CKEditor. In this tutorial, we'll show you how to enable Drupal's Insert Media button for CKEditor, and configure the corresponding text format so that it can render embedded Media entities.

Content authors can then use the Media Library to select images (or other media) to embed into the page.

In this tutorial we'll:

How to Add Fields to a Media Type in Drupal

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Drupal media entities are fieldable entities, which means that you can add any custom fields you want to your Media types. These fields can be used for collecting additional metadata about a resource, categorizing and organizing resources so they're easier to find in a large media library, or for displaying information like a photo credit or transcript for a video. The possibilities are endless once you know how to add, and optionally display, fields in Drupal.

Some example use cases for adding fields to Media types:

Map Media Source Data to Custom Fields

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Media Source plugins in Drupal have a powerful feature, called field mapping, that allows an administrator to configure a Media entity type to automatically populate the value of custom fields based on metadata retrieved from the source content. For example, you can add a creator field to the Remote Video Media type, which can use YouTube as a source. When a content author adds a new Remote Video entity they can provide a URL for the YouTube video. Then the source plugin can extract the creator's name from the YouTube API and use that data to populate a custom field.

Overview: Access Control for Media Entities in Drupal

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Access control for the Media entities in Drupal works in much the same way as any other content entity. The module provides fine-grained control over create, update, and delete operations, while providing only basic control over who can view Media assets. The thinking is that there are too many possible permutations of how an application may want to restrict read access to content. Therefore, rather than try and pick one setting and add it to core, it's left entirely up to the site administrator and contributed modules.

In this tutorial we'll:

Customize the Drupal Media Library Browser Widget

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

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:

Track Media Entity Usage in Drupal

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

One of the most powerful features of Drupal's Media Library is that it enables content authors to re-use media entities. Have a favorite image that you like to use with all blog posts about a specific topic? Or a default icon you want to use for a tutorial unless an alternative is provided? The Media Library can accommodate this without requiring you to keep a copy of the image locally and then attach it to every node where it's needed.

Use View Modes with Media Entities in Drupal

Site Building, Theming, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Media entities, like any content entity, work great with all the different features Drupal provides for changing the way things are displayed: view modes, Layout Builder, theme templates, and more. We're big fans of using view modes to create a component-like design system where entity types have view modes representing the different context in which they're displayed. Then we theme the view modes. This works great for displaying Media entities associated with a page and for changing the way that Media assets are displayed within the Media Library browser.

What Are Media Sources in Drupal?

Module Development, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Media source plugins provide the link between media entities in Drupal and the actual media asset itself. They are the code that understand the difference between an image, a video, and a Tweet, and perform the translation that allows the media ecosystem to treat all media entities equally. For example, local image files, and remote YouTube videos, can both be catalogued in a similar way as media entities, but they need very different handling when it comes to displaying them.

Create a New Media Type in Drupal

Module Development, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

Drupal site administrators can create new media entity types, with their own unique configurations and sets of associated fields. Different media types can be configured with different field names, permissions, moderation workflows, and display settings, making it possible to create truly custom content administration experiences. The process is similar to creating a node content type like articles or events with one major distinction: every media type inherits from a specific media source plugin.

Use Any oEmbed Provider as a Media Source

Module Development, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

If the Media assets you want to use in your library support oEmbed, then you might be able to use them with a minimal custom code. Before you go down the path of creating a custom media source plugin try this approach first.

Create a Custom Media Source Plugin

Module Development, Site Administration, Drupal 9, Drupal 8, Drupal 10

More information

The Drupal Media Library and Media ecosystem can be integrated with any third-party media provider by defining new media source plugins. Media types (Media entity bundles) have an important distinction compared to other content entity types like nodes. Every media type inherits from a specific media source plugin. The source plugin provides domain-specific knowledge about the kind of resource being represented. For example, media types dealing with images know how to validate file extensions and render <img> tags.