Last updated September 21, 2011. Created on December 24, 2010.
Edited by mikeryan. Log in to edit this page.

This documentation applies to Migrate V1 only - if you are just beginning with the Migrate module, ignore everything you see here and start with the Migrate V2 documentation.

The migrate module provides a flexible framework for migrating content into Drupal from other sources (e.g., when converting a web site from another CMS to Drupal). Out-of-the-box, support for creating Drupal nodes, users, and comments is included - hooks permit migration of other types of content.

In addition to performing the creation of Drupal objects from arbitrary data, migrate helps with the methodology of data migration:

  1. It lets admins/clients browse their legacy data before import into Drupal.
  2. From there, client may annotate columns so that everyone agrees on what the data means.
  3. It lets admins map their legacy table columns to core node fields, CCK fields, and taxonomy terms.
  4. It provides a dashboard for running mini migrations such as 'blog posts from 2004', and makes it easy to roll back after fixing a bug and re-migrate
  5. It provides Views for Quality Assurance, comparing legacy tables to new Drupal tables

Additional Resources

  1. Migrate Module Project Page
  2. lovely civicactions blog post

Looking for support? Visit the forums, or join #drupal-support in IRC.