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, 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, …).
• Host submodule Entity Reference Deck EB — Entity Browser field widgets (including multi-launcher with Entity Browser Multi).
• Host submodule Entity Reference Deck Paragraphs — Paragraphs field widget and closed-row chrome.
• Skin submodule Entity Reference Deck Gin — remaps --erdeck-* tokens when Gin is active.
• Optional soft-deps: content moderation, Diff (modal), Entity Usage badges, Paragraphs EE icons, Paragraphs Library view modes.

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 (and their hard dependencies).
3. Optionally enable entity_reference_deck_gin when using the Gin admin theme.
4. Go to Configuration → Content authoring → Entity Reference Deck for global action groups, meta items, and card defaults.
5. 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 and Entity Browser Multi
• For the Paragraphs host: Paragraphs (and Entity Reference Revisions)

Core only requires drupal:field. Soft-deps above are optional unless you enable the matching host / features.

Recommended modules/libraries

• Gin — with entity_reference_deck_gin for admin token remaps.
• Entity Usage — usage count badges on cards.
• Diff — revision diff actions in a modal.
• Core Content Moderation — moderation status actions on cards.

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; required by the EB host submodule, complementary to the deck chrome.
• Paragraphs — nested content widgets; the Paragraphs host wraps closed rows with deck chrome.

Supporting this Module

Development is supported by Big Blue Door.

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.