Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

VideoJS Media migrate

Security covered Under active development

Part of the Videojs ecosystem · 5 projects

This project automates the migration of your VideoJS Mediablock content to the newer VideoJS Media format. It allows you to update from the older block-based storage to the modern entity-based system, converting various media types like local files, remote streams, and YouTube videos. The process is managed through Drush commands for a smooth transition of your video and audio content.

Provides Migration API configurations to migrate VideoJS Mediablock block content entities to the modern VideoJS Media content entities. If you are moving from the videojs_mediablock module to videojs_media, this module automates that data migration via Drush.

Features

The videojs_mediablock module stores all video/audio content in a single block content bundle with up to five media fields. The videojs_media module replaces that with five lean, bundle-based content entities — one per media type — each carrying only the fields it needs.

This module bridges the two by providing five Migration API configurations (one per destination bundle) and a custom source plugin that inspects each videojs_mediablock block, determines the correct destination bundle, and maps its fields accordingly:

  • videojs_migrate_local_video — local MP4/WebM/OGG video files
  • videojs_migrate_local_audio — local MP3/OGG/AAC audio files
  • videojs_migrate_remote_video — HLS, DASH, or remote video URLs
  • videojs_migrate_remote_audio — remote audio stream URLs
  • videojs_migrate_youtube — YouTube URLs or video IDs

Shared fields (poster image, subtitles) are copied to all destination bundles. Drupal's migration tracking means you can roll back, reset, and re-run safely. All five migrations are grouped under videojs_media so they can be run or rolled back together with a single Drush command.

Post-Installation

After enabling this module, use Drush to run the migrations:

  1. Check status: drush migrate:status --group=videojs_media — you should see all five migrations listed.
  2. Run all at once: drush migrate:import --group=videojs_media
  3. Or run individually, e.g.: drush migrate:import videojs_migrate_local_video

To undo: drush migrate:rollback --group=videojs_media

If a migration gets stuck: drush migrate:reset-status videojs_migrate_local_video

Uninstalling this module after a successful migration does not delete the migrated entities — they remain in your database.

Additional Requirements

Install the contrib dependencies before enabling this module:

composer require drupal/migrate_plus drupal/migrate_tools
drush en migrate migrate_plus migrate_tools
drush en videojs_media_migrate

No additional modules are recommended beyond those listed above. Once migration is complete you may uninstall videojs_mediablock, videojs_media_migrate, migrate_plus, and migrate_tools if they are no longer needed.

Similar projects

  • VideoJS Mediablock — the predecessor block-based module this migration moves data away from.
  • VideoJS Media — the modern entity-with-bundles destination module.

Supporting this Module

This module is provided as free, open-source software under the GPL-2.0+ license. Contributions, bug reports, and feature requests are welcome via the drupal.org issue queue.

Community Documentation

Full usage instructions, field mapping tables, troubleshooting steps, and architecture details are available in the README.md included with this module.

Drupal 10–11

Ask your assistant about VideoJS Media migrate

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

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
3
Tracked since
Jun 2026
Latest release
1 week ago
Releases (12 mo)
3 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.0.1 Stable 10–11 Oct 17, 2026
1.0.0 Stable 10–11 Jun 18, 2026
1.0.x-dev Dev 10–11 Jun 18, 2026