Skip to content



List all migrations with current status.


  • migrate:status. Retrieve status for all migrations
  • migrate:status --tag. Retrieve status for all migrations, grouped by tag
  • migrate:status --tag=user,main_content. Retrieve status for all migrations tagged with user or main_content
  • migrate:status classification,article. Retrieve status for specific migrations
  • migrate:status --field=id. Retrieve a raw list of migration IDs.
  • ms --fields=id,status --format=json. Retrieve a Json serialized list of migrations, each item containing only the migration ID and its status.


  • [migrationIds]. Restrict to a comma-separated list of migrations. Optional.


  • --tag=TAG. A comma-separated list of migration tags to list. If only --tag is provided, all tagged migrations will be listed, grouped by tags.
  • --format[=FORMAT]. Format the result data. Available formats: csv,json,list,null,php,print-r,sections,string,table,tsv,var_dump,var_export,xml,yaml [default: table]
  • --fields=FIELDS. Available fields: Migration ID (id), Status (status), Total (total), Imported (imported), Needing update (needing_update), Unprocessed (unprocessed), Last Imported (last_imported) [default: id status total imported unprocessed last_imported]
  • --field=FIELD. Select just one field, and force format to string.
  • --filter[=FILTER]. Filter output based on provided expression

Global Options

  • -v|vv|vvv, --verbose. Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
  • -y, --yes. Auto-accept the default for all user prompts. Equivalent to --no-interaction.
  • -l, --uri=URI. A base URL for building links and selecting a multi-site. Defaults to https://default.
  • To see all global options, run drush topic and pick the first choice.



  • ms
  • migrate-status


  • An argument or option with square brackets is optional.
  • Any default value is listed at end of arg/option description.
  • An ellipsis indicates that an argument accepts multiple values separated by a space.