Overview
Dynamic Entity Reference provides a field type/widget/formatter combination for Drupal that allows an entity-reference field to reference more than one entity type.
Features
Create a single field to hold references to Users and Nodes, Or Terms and Nodes, or all three.
From 5.x also supports mixing config entities with content entities.
What version should I use?
Please read the 5.x release notes
New projects should start with the 5.x series.
Users on the 3.x and 4.x series should take a backup and then test the update path to 5.x and report back on this issue
5.x series
This will be the one version moving forward. Once a stable tag is cut 3.x and 4.x will be deprecated.
This version allows all content entities as referenceable entities. This version also allows all config entities as referenceable entities but it is only configurable programmatically. The content and config entities can be referenced in the same field as well. This is achieved with native Drupal typed-data features.
3.x series
This version only supports content entities with integer IDs as referenceable entities. It doesn't allow content entities with string IDs as referenceable entities.
4.x series
This version allows all content entities as referenceable entities. This version also allows all config entities as referenceable entities but it is only configurable programmatically. The content and config entities can be referenced in the same field as well. In contrast to the 5.x branch this relies on database triggers which are not supported on all hosting providers including Acquia.
Known problems
Please use the issue queue to report problems.issue_tags=DER%20issue">DER issues in core.
Credits
Development being undertaken by @larowlan and @jibran of PreviousNext
Tutorials
- Drupal modules the one percent did a screencast of this module in action (4 minutes long)
Project information
- Project categories: Site structure
29,056 sites report using this module
- Created by larowlan on , updated
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
The one where the 3.x and 4.x series come together 🔀
Development version: 5.x-dev updated 28 Jun 2026 at 22:25 UTC
The one with D12 support 💧1️⃣2️⃣
Development version: 4.x-dev updated 21 Jun 2026 at 04:05 UTC



