Dynamic Entity Reference
This module allows you to create a single field that can reference multiple types of entities, such as users, nodes, or taxonomy terms, all within the same field. It also supports mixing configuration entities with content entities.
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)
Depends on
Dependencies of the latest stable release
- field Drupal core
Required by
13 tracked projects depend on this one
- Scheduled Transitions 3,650 sites
- Preview Link 2,992 sites
- Entity log 422 sites
- Meta Entity 138 sites
- Entity Logger 50 sites
- Commerce Recruiting 37 sites
- Preview Site 16 sites
- Migrate QA 15 sites
- Slots 15 sites
- Workflow participants 12 sites
- Digital Signage Framework 9 sites
- Commerce License OG Role 3 sites
- Collection 2 sites
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 3.2.3 | Stable | 10–11 | The one where dkmishra fixed a PHP version requirement mismatch 🐘 | Aug 4, 2026 | |
| 5.0.0-rc1 | Pre-release | 11 | The one where the 3.x and 4.x series come together 🔀 | Jul 7, 2026 | |
| 5.x-dev | Dev | 11 | The one with no triggers 🔫 | Jun 28, 2026 | |
| 3.2.2 | Stable | 10–11 | The one with D12 support 💧1️⃣2️⃣ | Jun 21, 2026 | |
| 4.0.0-alpha7 | Pre-release | 10–11 | The one with D12 support 💧1️⃣2️⃣ | Jun 21, 2026 | |
| 4.0.0-alpha6 | Pre-release | 10–11 | The one that plays nicely with D10 💧🔟 | Feb 2, 2026 | |
| 4.0.0-alpha5 | Pre-release | 10–11 | Adds DER logo | Nov 12, 2025 | |
| 3.2.1 | Stable | 10–11 | The one with PHP 8.4 support amongst other things | Feb 25, 2025 |