Migrate Devel

Debug your Drupal migrations with ease. Migrate Devel provides developer tools to inspect source data, destination values, and entity IDs as rows are processed—right in your terminal.

Features

• --migrate-debug – View source, destination, and saved entity IDs after each row is processed
• --migrate-debug-pre – Inspect source and destination values before processing begins
• Debug process plugin – Add inline debugging to any migration YAML to trace values through the pipeline

Part of the Migrate Ecosystem

Migrate Devel works seamlessly with Migrate Tools and Migrate Plus. Use it alongside your existing migration workflow—just add a flag to your Drush command and start debugging.

Usage

Add debug flags to your migrate commands:

drush migrate:import my_migration --migrate-debug
drush migrate:import my_migration --migrate-debug-pre

Documentation

Full documentation is available in the README file, including:

• Drush command options and examples
• Debug process plugin configuration
• Integration with Migrate Tools and Migrate Plus

Related Modules

• Migrate Tools – Drush commands for running and managing migrations
• Migrate Plus – Additional source plugins, process plugins, and migration groups
• Migrate Source CSV – Import data from CSV files
• Migrate Manifest – Run migrations defined in a manifest file