Skip to content

Media Directories

Media Directories adds a directory (folder) structure to Drupal Media entities, backed by a taxonomy vocabulary. It ships with a Vue.js media browser and a set of CKEditor 5 integrations that let editors organise, find and embed media without leaving their content.

What's in the box

The project is a meta-module made up of several smaller modules:

Module Purpose
media_directories Core: directory field on Media entities and Media Library integration.
media_directories_browser Vue.js media browser with JSON:API backend and CKEditor 5 integration.
media_directories_file_link CKEditor 5 plugin for inserting file download links.
media_directories_ai AI-powered alt text generation and translation.
media_directories_compat Converts legacy <drupal-entity> embeds to <drupal-media> at render time.
media_directories_image_resize Resizes images in text content via explicit width/height attributes.

Where to go next

  • Installation — requirements, suggested dependencies and the configuration steps needed to get a working setup.
  • Configuration — a tour of the admin pages (main settings, Browser tab, AI tab) grouped by what each option actually does for editors.
  • Integrations — optional contrib and core modules (Focal Point, SVG Image, AI, Content Translation, Entity Usage, …) and what each one adds to the media browser.