Entity Reference Deck

Entity Reference Deck adds pluggable toolbar actions and erdeck-card chrome to entity reference fields. Editors get moderation, usage, diff, and other actions on reference cards without a custom widget per site.

It ships host submodules for Entity Browser and Paragraphs, feature submodules for Diff, Entity Usage, Content Moderation styling, and Paragraphs Library, an optional live Preview submodule, plus an optional Gin admin theme skin.

Features

• Core module — action / meta / group plugin managers, card builder, global settings form, SDC components (erdeck-card, status tags, usage badges, …). Core works without Diff / Entity Usage / Content Moderation / Paragraphs Library installed.
• Host submodule Entity Reference Deck EB — Entity Browser field widgets (optional multi-launcher with Entity Browser Multi).
• Host submodule Entity Reference Deck Paragraphs — Paragraphs field widget and closed-row chrome (icons via ParagraphsType::getIconUrl()).
• Feature submodule Entity Reference Deck Diff — revision compare action and modal (entity_reference_deck_diff; requires Diff).
• Feature submodule Entity Reference Deck Usage — usage surfaces (entity_reference_deck_usage; requires Entity Usage).
• Feature submodule Entity Reference Deck Moderation — Content Moderation–aware card styling (entity_reference_deck_moderation).
• Feature submodule Entity Reference Deck Paragraphs Library — library item theme + type presentation (entity_reference_deck_paragraphs_library; requires the Paragraphs host and Paragraphs Library).
• Soft-dep submodule Entity Reference Deck Preview — live front-end preview of referenced entities in cards (entity_reference_deck_preview). Does not ship iframe-resizer; install it on the site (see Additional Requirements).
• Skin submodule Entity Reference Deck Gin — remaps --erdeck-* tokens when Gin is active.

When to use it: you want a consistent card + toolbar UX on entity reference fields (browse / reorder / edit referenced entities) with site-extensible actions, without rewriting Entity Browser or Paragraphs widgets from scratch.

Post-Installation

1. Enable Entity Reference Deck (entity_reference_deck).
2. Enable the host you need: entity_reference_deck_eb and/or entity_reference_deck_paragraphs (after composer require of their packages).
3. Enable feature submodules as needed: entity_reference_deck_diff, entity_reference_deck_usage, entity_reference_deck_moderation, entity_reference_deck_paragraphs_library.
4. Optionally enable entity_reference_deck_preview, then install iframe-resizer on the site (see Additional Requirements).
5. Optionally enable entity_reference_deck_gin when using the Gin admin theme.
6. Go to Configuration → Content authoring → Entity Reference Deck for global action groups, meta items, and card defaults.
7. On Structure → Content types → [type] → Manage form display, set the entity reference field widget to an ER Deck host widget.

There is no new content type. Configuration is the module settings form plus field form-display widget settings.

Additional Requirements

• Drupal core ^11.4
• PHP 8.3+
• For the EB host: Entity Browser
• For the Paragraphs host: Paragraphs and Entity Reference Revisions
• For Preview only: install iframe-resizer v5 on the site (not shipped with the module): composer require npm-asset/iframe-resizer--parent:^5 npm-asset/iframe-resizer--child:^5 via Asset Packagist, with npm-asset packages under web/libraries/{$name}. Expected files: /libraries/iframe-resizer--parent/index.umd.js and /libraries/iframe-resizer--child/index.umd.js.

Core only requires drupal:field. Host and feature packages are required only when you enable the matching submodule.

Recommended modules

• Gin — with entity_reference_deck_gin for admin token remaps.
• Entity Browser Multi — optional with entity_reference_deck_eb; multi-launcher fields get the same deck FieldWidgetDisplay.
• Diff — with entity_reference_deck_diff for revision compare in a modal.
• Entity Usage — with entity_reference_deck_usage for usage surfaces.
• Core Content Moderation — with entity_reference_deck_moderation for CM-aware card styling.
• Paragraphs Library — with entity_reference_deck_paragraphs_library (after the Paragraphs host).
• Responsive Preview — optional with entity_reference_deck_preview for device presets in the field toolbar.

Similar projects

• Entity Browser — browse/select UX; this module adds card chrome and toolbar actions on top of EB (and Paragraphs) hosts.
• Entity Browser Multi — multiple EB launchers on one field; optional soft-dep for the EB host, complementary to the deck chrome.
• Paragraphs — nested content widgets; the Paragraphs host wraps closed rows with deck chrome.
• Entity Reference Revisions — revision-aware entity references used with Paragraphs.

Community Documentation

• Module README and source: https://git.drupalcode.org/project/entity_reference_deck
• Issue queue: https://www.drupal.org/project/issues/entity_reference_deck

Note: This project is not (yet) covered by Drupal’s security advisory policy. Use accordingly until it opts into the security team process.