Drupal is a registered trademark of Dries Buytaert
Release: Drupal 10.3.6 Update released for Drupal core (10.3.6)! Release: Drupal 11.0.5 Update released for Drupal core (11.0.5)! Release: Drupal 10.2.9 Update released for Drupal core (10.2.9)! Release: Drupal 10.2.10 Update released for Drupal core (10.2.10)! Release: Drupal 10.3.7 Update released for Drupal core (10.3.7)! Release: Drupal 11.0.6 Update released for Drupal core (11.0.6)! Release: Drupal 10.3.8 Update released for Drupal core (10.3.8)! Release: Drupal 11.0.7 Update released for Drupal core (11.0.7)! Module Revived: Translation Management Tool 8.x-1.19 Module tmgmt updated after 7 months of inactivity (8.x-1.19). Usage Milestone: Account field split Module account_field_split crossed 10,000 active installs.

Entity Reference Purger removes orphaned (dangling) entity references when an entity is deleted.

Problem/Motivation

Entity reference field items are not removed when the referenced entity is deleted.

E.g.

  1. Create taxonomy term "dogs" (tid: 1).
  2. Create taxonomy term "cats" (tid: 2).
  3. Create node "Animals" with references to terms dogs & cats.
  4. Delete the "dogs" term. Node "Animals" will still have reference to term "dogs" even though there is no longer such a term.

This is not a problem if you are using Drupal UI or you are not validating entities before saving (programmatically). Some examples where it can cause problems:

  • Validation errors when using $entity->validate()
  • Search facets with an incorrect count of results.
  • Cryptic error messages when editing entities that contain collapsed Paragraphs.
  • Null fields in GraphQL results (which is invalid GraphQL).
  • ...

How this module works

This module will automatically remove all orphaned (dangling) entity references from parent entities on child entity delete. All you need to do is to enable this option in the entity reference field settings. To handle performance issues on huge systems with tens of thousands (or more) dangling references using "Queue option" is recommended.

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
1
Tracked since
Dec 2024
Latest release
1 year ago
Releases (12 mo)
0 ▼ from 1
Maintenance
Dormant

Releases

Version Type Core Release date
1.0.0-beta8 Pre-release Dec 26, 2024