No. The Media module defines media items, media types and their sources. The Media Library module depends on it and adds the browsing screens, the picker dialog and the field widget. You can use Media without Media Library, but the picker needs it.
' - '@type': Question name: 'How do I add the Media Library button to the text editor?' acceptedAnswer: '@type': Answer text: 'Edit the text format, add the Drupal media button to the CKEditor 5 toolbar, and enable the Embed media filter. In Drupal 11.4.10 the plugin has a condition that requires that filter. The module's help text describes both steps but still calls the button Insert from Media Library.
' - '@type': Question name: 'Why does my media field still show the old widget?' acceptedAnswer: '@type': Answer text: 'Field UI makes the Media library widget the default only when it creates a media reference field. For an existing field, open the form display of the content type and select the Media library widget for that field.
' - '@type': Question name: 'Can editors upload files inside the picker?' acceptedAnswer: '@type': Answer text: 'Yes, if the user may create media of that type and the type has an add form. In 11.4.10 the module supplies add forms for image, file, audio file and video file sources, plus a URL form for remote video.
' - '@type': TechArticle headline: 'Media Library' description: 'Media Library is the core Drupal module that lets editors upload a media item once and pick it again from any media field or the text editor.' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-26T18:01:04+0000' dateModified: '2026-10-26T18:01:04+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/hc/documentation/learn-drupal/drupal-glossary/media-library' articleSection: 'Drupal glossary' - '@type': WebPage '@id': 'https://dxpr.com/hc/documentation/learn-drupal/drupal-glossary/media-library' description: 'Media Library is the core Drupal module that lets editors upload a media item once and pick it again from any media field or the text editor.' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Home item: 'https://dxpr.com/' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: en --- [Help Center](/hc)/[Documentation](/hc/documentation) /[Learn Drupal](/hc/documentation/learn-drupal) /[Drupal glossary](/hc/documentation/learn-drupal/drupal-glossary) # Media Library Media Library is the core Drupal module that lets editors upload a media item once and pick it again from any media field or the text editor. Learn DrupalDrupal glossary Last updated October 26, 2026 ## In this guide Related terms - [Reference field](/hc/documentation/learn-drupal/drupal-glossary/reference-field) - [Field widget](/hc/documentation/learn-drupal/drupal-glossary/field-widget) - [Image style](/hc/documentation/learn-drupal/drupal-glossary/image-style) - [WYSIWYG](/hc/documentation/learn-drupal/drupal-glossary/wysiwyg) - [Text format](/hc/documentation/learn-drupal/drupal-glossary/text-format) - [Drupal Canvas (formerly Experience Builder)](/hc/documentation/learn-drupal/drupal-glossary/drupal-canvas) [All Drupal terms from A to Z](/hc/documentation/learn-drupal/drupal-glossary) Media Library is a core Drupal module that builds on the Media module. It gives the media list a Grid view next to the Table view, and it opens a pop-up where editors choose or upload media for a reference field or the text editor. The Media module still stores the items; Media Library changes how people find and pick them. ## How it works in Drupal 11 The module lives in core and depends on Media, Views and User. In Drupal 11.4.10 each of core's media-type recipes (Image, Document, Audio, Local video and Remote video) installs it, so applying any of those recipes enables the module. Three parts do the work. First, the administration screen at `/admin/content/media` gets Table and Grid tabs; the grid lives at `/admin/content/media-grid`. Second, the dialog titled Add or select media shows one vertical tab per allowed media type, and an Insert selected button. Third, a field widget with the ID `media_library_widget` and the label Media library works on [reference fields](/hc/documentation/learn-drupal/drupal-glossary/reference-field) that point to media. It adds an Add media button to the edit form. The screens are ordinary Views. The grid shows each media type in its Media library view mode and uses the image style named Media Library thumbnail (220×220). The upload form in the dialog uses the Media library form mode. The settings page at `/admin/config/media/media-library` has one switch, Enable advanced UI, which ships turned off. With it on, people who add media in the dialog see a summary of their selection and can insert it directly. For text, the CKEditor 5 plugin definition adds a Drupal media toolbar item. It only works when the text format enables the Embed media filter. ## Example You want every article to have a hero image. Go to `Structure › Content types › Article › Manage fields` and add a Media reference field that allows the Image type. Field UI selects the Media library widget for it. An editor now sees an Add media button, picks an image from the grid or uploads a new one, and chooses Insert selected. Next month, another article can reuse the same image without a second upload. ## Common mistakes - **Leaving a field without allowed types.** The widget then shows a message that no allowed media types are configured for the field. Edit the field settings and select at least one type. - **Customizing the wrong place.** To change what the grid shows, edit the Media library view mode of the media type. To change thumbnail size, edit the image style. - **Skipping permissions.** The picker requires the `view media` permission. The upload form for a media type appears only if the user may create media of that type. ## For marketing and content teams Treat the library as the one shelf for images, documents and videos. Upload an asset once, then pick it wherever a field or an [editor](/hc/documentation/learn-drupal/drupal-glossary/wysiwyg) asks for media. Use the Grid tab to browse by thumbnail and the Table tab for details such as names and dates. Before you replace an image, check where it is used, since the same item can appear on several pages. Developers decide which media types each field accepts, so ask them if a type is missing. Page builders can depend on the library too. [Drupal Canvas](/hc/documentation/learn-drupal/drupal-glossary/drupal-canvas) 1.12.0 lists Media Library as a dependency in its info file, so installing Canvas also installs Media Library. ## Sources - [Drupal.org: Media Library module documentation](https://www.drupal.org/docs/8/core/modules/media-library-module) - [Drupal core 11.4.10: Media Library module source](https://git.drupalcode.org/project/drupal/-/tree/11.4.10/core/modules/media_library) - [Drupal core 11.4.10: Media module source](https://git.drupalcode.org/project/drupal/-/tree/11.4.10/core/modules/media) - [Drupal core 11.4.10: CKEditor 5 plugin definitions](https://git.drupalcode.org/project/drupal/-/blob/11.4.10/core/modules/ckeditor5/ckeditor5.ckeditor5.yml) - [Drupal core 11.4.10: Image media type recipe](https://git.drupalcode.org/project/drupal/-/blob/11.4.10/core/recipes/image_media_type/recipe.yml) - [Drupal Canvas 1.12.0: module info file](https://git.drupalcode.org/project/canvas/-/blob/1.12.0/canvas.info.yml) ## Questions about Media Library ### Is the Media Library the same as the Media module? No. The Media module defines media items, media types and their sources. The Media Library module depends on it and adds the browsing screens, the picker dialog and the field widget. You can use Media without Media Library, but the picker needs it. ### How do I add the Media Library button to the text editor? Edit the text format, add the Drupal media button to the CKEditor 5 toolbar, and enable the Embed media filter. In Drupal 11.4.10 the plugin has a condition that requires that filter. The module's help text describes both steps but still calls the button Insert from Media Library. ### Why does my media field still show the old widget? Field UI makes the Media library widget the default only when it creates a media reference field. For an existing field, open the form display of the content type and select the Media library widget for that field. ### Can editors upload files inside the picker? Yes, if the user may create media of that type and the type has an add form. In 11.4.10 the module supplies add forms for image, file, audio file and video file sources, plus a URL form for remote video. ## Cite this definition "Media Library." DXPR Drupal glossary, https://dxpr.com/hc/documentation/learn-drupal/drupal-glossary/media-library. Last updated October 26, 2026. Copy ## Related terms - [Reference field](/hc/documentation/learn-drupal/drupal-glossary/reference-field) - [Field widget](/hc/documentation/learn-drupal/drupal-glossary/field-widget) - [Image style](/hc/documentation/learn-drupal/drupal-glossary/image-style) - [WYSIWYG](/hc/documentation/learn-drupal/drupal-glossary/wysiwyg) - [Text format](/hc/documentation/learn-drupal/drupal-glossary/text-format) - [Drupal Canvas (formerly Experience Builder)](/hc/documentation/learn-drupal/drupal-glossary/drupal-canvas) [All Drupal terms from A to Z](/hc/documentation/learn-drupal/drupal-glossary)