Tag1 Consulting’s Latest Guide: Migrating Nodes from Drupal 7 to Drupal 10

Staff Reporter

Tag1 Consulting has released the 29th installment in its Migrations How-To series. Mauricio Dinarte's latest article focuses on migrating nodes from Drupal 7 (D7) to Drupal 10 (D10). It covers essential steps for handling basic pages and articles while ensuring data integrity.

The article highlights the importance of creating a custom source plugin to filter out unpublished nodes before import, optimizing performance and migration accuracy. It also revisits key topics such as entity relationships, ID management, and high-water mark considerations, which are critical for maintaining content structure and avoiding inconsistencies.

The guide follows Drupal’s migrate API and Extract, Transform, and Load (ETL) principles. It provides a systematic approach to managing dependencies like users, taxonomy terms, and media. The article explains how to set AUTO_INCREMENT values for node entities, configure the high water property for incremental migrations, and implement filtering mechanisms to prevent the import of unpublished content. A custom source plugin, 'tag1_d7_node' extends Drupal’s core migration plugins, modifying SQL queries to exclude unpublished nodes.

The piece further outlines entity relationships, emphasizing the need to properly link migrated content types, users, taxonomy terms, and media entities. Adjustments in text formats and image field mappings are also covered, ensuring Drupal 10’s media reference fields replace the Drupal 7 image field structure. The report concludes by explaining migration lookup operations and the order of entity migrations to maintain dependencies. The next installment will cover the remaining content types awaiting migration.

This article is part 1 of the Nodes migration series. Visit the Tag1 blog for the latest updates.

Source Reference

Title

Migrating Your Data from D7 to D10: Migrating nodes - Part 1

Byline

Mauricio Dinarte

Date of Publication

21 February 2025

Organization

Tag1 Consulting

Image Attribution Disclaimer: At The Drop Times (TDT), we are committed to properly crediting photographers whose images appear in our content. Many of the images we use come from event organizers, interviewees, or publicly shared galleries under CC BY-SA licenses. However, some images may come from personal collections where metadata is lost, making proper attribution challenging.

Our purpose in using these images is to highlight Drupal, its events, and its contributors—not for commercial gain. If you recognize an image on our platform that is uncredited or incorrectly attributed, we encourage you to reach out to us at #thedroptimes channel on Drupal Slack.

We value the work of visual storytellers and appreciate your help in ensuring fair attribution. Thank you for supporting open-source collaboration!

Drupal 7 Migration

Drupal 10

Tag 1 Consulting

Disclosure: This content is produced with the assistance of AI.

Disclaimer: The opinions expressed in this story do not necessarily represent that of TheDropTimes. We regularly share third-party blog posts that feature Drupal in good faith. TDT recommends Reader's discretion while consuming such content, as the veracity/authenticity of the story depends on the blogger and their motives.

Note: The vision of this web portal is to help promote news and stories around the Drupal community and promote and celebrate the people and organizations in the community. We strive to create and distribute our content based on these content policy. If you see any omission/variation on this please reach out to us at #thedroptimes channel on Drupal Slack and we will try to address the issue as best we can.