This project is not covered by Drupal’s security advisory policy.

If you are using a Paragraphs-based Drupal website, you may be looking for a simpler way to drill down into nested Paragraphs, as well as a simple way to group and tidy up the Paragraphs and other fields on your edit pages.

Paragraph Group module is designed primarily to address both of these use cases in a cleverly integrated way. The module tidies up Drupal’s content editing forms, and makes nested groups of Paragraphs easier to edit and manage, by integrating the Paragraphs and Field Group modules with a Content Architecture philosophy:

  • At the horizontal level of fields in a Content Type, disorganized fields should, wherever practical, be organized into Field Groups.
  • At the vertical level of drilling down into nested Paragraphs, the Paragraphs should also be easy to navigate and locate via an Accordion or HTML Details widget.

Paragraph Group module achieves the above objectives through 5 main module features:

  1. Paragraph Details Widget: The main module feature is an improved editing widget for Paragraph fields, called the Paragraph Details widget, based on the HTML Details element — the native HTML successor to the jQueryUI Accordion Widget. Accompanied by helpful toggle buttons, the Paragraph Details widget facilitates easy and intuitive drilling down into and navigation of nested Paragraphs. Through this Accordion functionality, the Paragraph Details widget achieves the second objective above. (See brief demo gif or full demo gif)
  2. Administrative Title Field: An Administrative Title Field for Paragraphs which integrates with the above Paragraph Details widget's summary text. This makes it easy to add a summary field to Paragraphs and keep track of the names of your Paragraph fields without using your own content field. (See screenshot)
  3. Automated Field Groups: Paragraph Group module can easily put all the fields of your Content Types into a sensible set of Field Groups, if the Content Type and fields meet a minimal set of requirements. In this way, Paragraph Group module achieves the first objective above. (See animated gif)
  4. Settings Page: It is not enough to merely offer a useful widget if you want that widget to be used across hundreds of different fields or entities. Paragraph Group module’s settings page makes it easy to apply the above 3 features to all relevant site components, and automates the process of doing so via ticking and submitting a checkbox form. (See animated gif)
  5. Theme Compatibility: The settings page also enables you to setup bespoke styling modifications in order to maximize the compatibility of your Administration Theme with both the Paragraphs and Paragraph Group modules (in version 2 of this module).

With Paragraph Group module, you no longer have to choose between the depth of nested Paragraphs, and the breadth of a Field Groups based Content Architecture. You can have tidy, coherent edit forms with the best of both worlds, significantly improving the content authoring experience of your Drupal site.

Please click the screenshots to see animated gifs of the module in action.


Requirements

Paragraph Group module requires:

  • The Paragraphs and Field Group contributed Drupal modules installed as dependencies.
  • One of the Claro, Gin or Seven themes to be set as the site’s Administration Theme. Claro is now the core Drupal Administration Theme in Drupal 9 and 10.

Installation

As shown in the release box below, the current release can be installed via composer by typing the following at your website environment’s command prompt:

composer require 'drupal/paragraph_group:^2.0'

Development Notes

Paragraph Group module is robustly written and follows all relevant Drupal best practices. (Check for yourself at https://git.drupalcode.org/project/paragraph_group.) As always, new site configurations should be tested on a non-production version of your website first.

Project information

Releases