This module helps migrate media from Drupal 7 to Drupal 8, 9, or 10. It converts Drupal 7 media and managed files into core media entities in the newer versions. It also migrates file fields into media reference fields and updates how media is embedded in text content.
☝️ Media Migration is still is in alpha stability!
Based on Drupal standards, only beta+ releases should provide full update path between releases. Please be prepared for breaking changes whenever updating from an alpha release!
This module provides a Drupal 7 to Drupal 8|9|10 migration path for the Drupal 7 Media module.
- Drupal 7 media entities are migrated into Drupal 8|9|10 core media entities, based on the type of the source File Entity.
- Simple Drupal 7 managed files are also migrated into Drupal 8|9|10 core media entities. Their type depends on the main MIME type of the original file.
- Image and file fields of the Drupal 7 source instance are migrated as media reference fields in Drupal 8|9|10.
- Fields attached to media/file entities in Drupal 7 are created and attached to their respective media bundles in Drupal 8|9|10.
- Media WYSIWYG tokens are transformed into Entity Embed or core media HTML tags (see this change record).
- Image tags used in formatted text fields are transformed to embed HTML tags
- CKEditor Link File links used in formatted text fields are transformed to Linkit links if Linkit is installed on the destination site.
Related Drupal core issues:
Ask your assistant about Media Migration
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
- Migrate Magician
- Migrate Magician migmag_process
- Migrate Plus
- Smart SQL ID Map
- media Drupal core
- migrate_drupal Drupal core
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | PHP | Release date | |
|---|---|---|---|---|---|
| 8.x-1.0 | Stable | 10–11 | Oct 30, 2026 | ||
| 8.x-1.0-alpha16 | Pre-release | 8–10 | Feb 21, 2023 | ||
| 8.x-1.0-alpha15 | Pre-release | 8–9 | Feb 20, 2023 |