Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Entity Reference Purger

Security covered Under active development 2,398 sites

Part of the Entity ecosystem · 306 projects

This module automatically removes dangling entity references from parent entities when the referenced entity is deleted. This prevents issues like validation errors, incorrect search counts, and broken GraphQL results caused by references to non-existent entities.

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.

Ask your assistant about Entity Reference Purger

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

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
5
Tracked since
Jan 2024
Latest release
1 year ago
Releases (12 mo)
0 ▼ from 1
Maintenance
Dormant

Release Timeline

Releases

Version Type Core PHP Release date
1.0.0-beta8 Pre-release 10–11 Dec 26, 2024
1.0.0-beta7 Pre-release 9–11 May 9, 2024
1.0.0-beta6 Pre-release 9–10 Apr 16, 2024
1.0.0-beta5 Pre-release 9–10 Mar 29, 2024
1.0.0-beta4 Pre-release 9–10 Jan 28, 2024