Skip to main content
Drupal is a registered trademark of Dries Buytaert
Release: OpenID Connect / OAuth client 3.0.0-alpha9 New alpha version released for module openid_connect (3.0.0-alpha9). Release: Opensolr Search 4.5.0 Minor update available for module opensolr_search (4.5.0). Release: Timelinr 1.0.1 Minor update available for module timelinr (1.0.1). Usage Milestone: Simplify Module simplify crossed 10,000 active installs. Usage Milestone: Views Reference Filter Module entityreference_filter crossed 10,000 active installs. Usage Milestone: Dropdown Language Module dropdown_language crossed 10,000 active installs. Usage Milestone: Paragraphs Browser Module paragraphs_browser crossed 10,000 active installs. Usage Milestone: OpenAPI Module openapi crossed 10,000 active installs. Usage Milestone: Decoupled Router Module decoupled_router crossed 10,000 active installs. Module Revived: Entityqueue Buttons 1.1.2 Module entityqueue_buttons updated after 8 months of inactivity (1.1.2).

Migrate Plus - Merge duplicated terms

29 sites Security covered Drupal 9–11
View on drupal.org

This module helps deduplicate taxonomy terms during content migration. It merges duplicate terms by migrating only the first occurrence and mapping any associated content to that single migrated term. This ensures that even if terms have different IDs in the source but the same name, content referencing them will be correctly linked to the single, unified term in Drupal.

This module provides a plugin which dedupe taxonomy terms merging them into one during a migration.

If you have duplicated terms in a vocabulary you are about to migrate, this plugin will only migrate the first occurrence of a term, skip the other rows with the same name but it will map the migrated term id with every source id which has the same name (so if you have other content tagged with these skipped terms id, those content will be attached to the term id that has been migrated when you will use the migration_lookup).

If you want to merge different terms name into one during your migration, you just need to rename those terms in your source (database, csv, json, etc.) so that they have the same name, then use this plugin during the migration and that's all.

Use case example

Requirements

This module requires the following modules:

Installation

Install as you would normally install a contributed Drupal module. Visit
https://www.drupal.org/node/1897420 for further information.

How to use it

Add the following lines in your migration yml file and just replace "source_field" & "vocabulary_id" by the values you need:

process:
  name:
    plugin: merge_duplicated_terms
    source: source_field
destination:
  plugin: 'entity:taxonomy_term'
  default_bundle: vocabulary_id

Known issues

If the terms in your source have parents, please make sure to order your source so that you always have parents first and then children or you might have some of your terms attached to a wrong parent https://www.drupal.org/project/migrate_merge_duplicated_terms/issues/332...

Depends on

Dependencies of the latest stable release

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
3
Tracked since
Feb 2025
Latest release
4 months ago
Releases (12 mo)
2 ▲ from 1
Maintenance
Active

Release Timeline

Releases

Version Type Core Release date
2.0.0-alpha1 Pre-release 11 Apr 28, 2026
2.0.x-dev Dev 11 Apr 28, 2026
1.0.2 Stable 9–11 Feb 19, 2025