The Media Library field widget

This guide explains how to configure the Media Library widget for entity reference fields that link to media items.

By using the Media Library widget with your media reference fields, you can streamline content creation and improve the overall media management experience for your editors.

The media library can be used with any entity reference field that references Media entities. (It does not support any other field types at the time of this writing.) We would refer to such a field as a "media reference" field from here on out.

Prerequisites:

The Media Library module should already be installed on your Drupal site. See the Overview page for installation instructions.

What is a Media Reference Field?

A media reference field allows you to associate media items (images, videos, documents, etc.) with your content. The Media Library widget provides a user-friendly interface for selecting and adding media to these fields.

Using the Media Library Widget:

By default, any newly created media reference field will automatically use the Media Library widget. However, you can also configure existing fields to use the Media Library:

1. Navigate to the Field Configuration Page: Locate the content type (or other entity bundle) containing the media reference field you want to modify. Go to the "Manage fields" tab for that entity bundle (e.g., /admin/structure/types/manage/article/fields).

2. Find the Media Reference Field: Locate the media reference field you want to configure on "Manage form display" tab.

3. Change the Widget: Click the "Edit" link for the field or the gear icon next to the field label. In the edit form, change the "Widget" setting to "Media library" and save the configuration.

Media Library Widget Settings (Deprecated):

There are no more additional settings for the Media Library widget including Media Tab Order.