Migrate API

Migrate API overview

The Migrate API provides services for migrating data from different sources.

Migrate source plugins

Migrate API source plugins extract the data from the source. Examples include CSV, SQL table and JSON sources.

• Overview of migrate source plugins
• Modifying Source Plugins
• Migrating data from a CSV source
• Migrating data from a JCR source
• Migrating data from a SQL source
• Migrating data from XML, JSON or SOAP source

Migrate process plugins

Processing pipeline of a Drupal 8 migration and the general purpose process plugins provided by core and contrib modules.

• Migrate process overview
• Constant values
• List of migrate process plugins
• Process plugins from contrib modules
• Writing a process plugin
• Chaining Migrations using migration_lookup

Migrate destination plugins & examples

Examples on how to migrate nodes, users and other entities to Drupal 8.

• Migrating nodes
• Migrating taxonomy terms
• Migrating users
• Migrating users - advanced password hash examples
• Migrating files and images
• Migrating Media
• Migrating configuration entities
• Migrating Commerce 2 Product Variations

Executing migrations

This page describes how migration definitions can be imported and executed.

Writing migrations for contributed and custom modules

Examples for writing migrations for contributed and custom modules.

Migration Tests

This is a overview of the types of migration tests in Drupal core.

Generating database fixtures for migration tests

Introduction to creating test fixtures for use in testing Drupal 6 or Drupal 7 migrations.

Debugging migrations

This page describes how migration definitions can be debugged.

Migrate field plugins

Field plugins provide a direct upgrade solution from D6 and D7 fields to modern Drupal equivalents

• Overview of migrate field plugins

Process Pipelines

Process plugins are the building blocks of migrations. Here are some examples of stacking those blocks into towers for real-life purposes.