Paragraphs EE Auto Open
This module automatically opens the Paragraphs EE type picker when an empty paragraphs field loads, allowing editors to immediately select a component type. It can be enabled on a per-field basis and works with any form using the Paragraphs EE modal.
Paragraphs EE Auto Open optionally auto-opens the Paragraphs EE type picker when an empty paragraphs field widget loads. Editors land on the EE type picker immediately instead of an empty paragraphs field.
It is aimed at site builders who use Paragraphs EE (for example “Add component” or library-item create flows) and want the type picker to appear as soon as an empty paragraphs field opens — without custom theme JS.
The module is generic to Paragraphs EE: it works on any form that renders a Paragraphs widget with the Paragraphs EE type picker (modal), not only paragraphs_library_item forms.
Features
- Per-field opt-in via paragraphs field widget third-party setting
auto_open(checkbox Auto-open EE type picker on Manage form display → widget settings). - Adds CSS class
paragraphs-ee-auto-openplus a small JS behavior that callsDrupal.paragraphsAddModal.openDialog. - Scoped to the opted-in field widget (safe on multi-field forms).
- Opens only when the field has the Paragraphs EE type picker markup and no paragraph items yet (skips edit / already-filled fields).
- Retries briefly while the Paragraphs EE modal API finishes loading.
When to use it: a create or edit form already uses Paragraphs EE for type selection, and you want that picker to open automatically on an empty field. Typical cases: create a reusable library item, or any host that embeds a paragraphs field with EE enhancements.
Post-Installation
- Require and enable the module:
composer require drupal/paragraphs_ee_auto_open
drush en paragraphs_ee_auto_open -y - On the relevant form display (e.g.
paragraphs_library_itemdefault), open the paragraphs field widget settings and enable Auto-open EE type picker. - Confirm the form uses Paragraphs EE’s type picker (modal); on an empty field the picker should open automatically.
There is no new content type. Configuration is third-party settings on core.entity_form_display.*.yml → content.{field}.third_party_settings.paragraphs_ee_auto_open.
Additional Requirements
- Drupal core
^11.4 - PHP 8.3+
- Paragraphs
^1 - Paragraphs EE
^10.1
No external APIs or additional JS libraries beyond what Paragraphs EE already provides. Entity Browser is not required.
Recommended modules
- Paragraphs Library — common host for create forms that use Paragraphs EE.
- Entity Browser — optional shell for create/reuse flows; auto-open is configured on the host form’s paragraphs widget, not on the browser.
- Gin — optional admin theme when styling create UI.
Similar projects
- Paragraphs EE — provides the type-picker modal this module auto-opens.
- Paragraphs Features — also uses field widget third-party settings for paragraphs widgets.
Supporting this Module
Maintained by Big Blue Door. Sponsorship, co-maintainership, and issue triage help keep the project moving — use the issue queue for bugs and feature requests.
Community Documentation
- Module README and source: https://git.drupalcode.org/project/paragraphs_ee_auto_open
- Issue queue: https://www.drupal.org/project/issues/paragraphs_ee_auto_open
Note: This project is not (yet) covered by Drupal’s security advisory policy. Use accordingly until it opts into the security team process.