Skip to content



Perform one or more migration processes.


  • migrate:import --all. Perform all migrations
  • migrate:import --all --no-progress. Perform all migrations but avoid the progress bar
  • migrate:import --tag=user,main_content. Import all migrations tagged with user and main_content tags
  • migrate:import classification,article. Import new terms and nodes using migration classification and article
  • migrate:import user --limit=2. Import no more than 2 users using the user migration
  • migrate:import user --idlist=5. Import the user record with source ID 5
  • migrate:import node_revision --idlist=1:2,2:3,3:5. Import the node revision record with source IDs [1,2], [2,3], and [3,5]
  • migrate:import user --limit=50 --feedback=20. Import 50 users and show process message every 20th record
  • migrate:import --all --delete. Perform all migrations and delete the destination items that are missing from source


  • [migrationIds]. Comma-separated list of migration IDs.


  • --all. Process all migrations
  • --tag=TAG. A comma-separated list of migration tags to import
  • --limit=LIMIT. Limit on the number of items to process in each migration
  • --feedback=FEEDBACK. Frequency of progress messages, in items processed
  • --idlist=IDLIST. Comma-separated list of IDs to import. As an ID may have more than one column, concatenate the columns with the colon ':' separator
  • --update. In addition to processing unprocessed items from the source, update previously-imported items with the current data
  • --force. Force an operation to run, even if all dependencies are not satisfied
  • --execute-dependencies. Execute all dependent migrations first
  • --timestamp. Show progress ending timestamp in progress messages
  • --total. Show total processed item number in progress messages
  • --progress[=PROGRESS]. Show progress bar [default: 1]
  • --delete. Delete destination records missed from the source. Not compatible with --limit and --idlist options, and high_water_property source configuration key.
  • --no-progress. Negate --progress option.

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.



  • mim
  • migrate-import


  • 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.