Drupal is a registered trademark of Dries Buytaert
drupal 11.3.8 — Update released for Drupal core (11.3.8)! drupal 11.3.7 — Update released for Drupal core (11.3.7)! drupal 11.2.11 — Update released for Drupal core (11.2.11)! drupal 10.6.7 — Update released for Drupal core (10.6.7)! drupal 10.5.9 — Update released for Drupal core (10.5.9)! cms 2.1.1 — Update released for Drupal core (2.1.1)! drupal 11.3.6 — Update released for Drupal core (11.3.6)! drupal 10.6.6 — Update released for Drupal core (10.6.6)! cms 2.1.0 — Update released for Drupal core (2.1.0)! video_embed_field 3.1.0 — Minor update available for module video_embed_field (3.1.0). bootstrap 8.x-3.40 — Minor update available for theme bootstrap (8.x-3.40). menu_link_attributes 8.x-1.7 — Minor update available for module menu_link_attributes (8.x-1.7). commerce 3.3.5 — Minor update available for module commerce (3.3.5). geocoder 8.x-4.34 — Minor update available for module geocoder (8.x-4.34). leaflet 10.4.5 — Minor update available for module leaflet (10.4.5). eca 3.1.1 — Minor update available for module eca (3.1.1). layout_paragraphs 2.1.3 — Minor update available for module layout_paragraphs (2.1.3). ai 1.3.3 — Minor update available for module ai (1.3.3). ai 1.2.14 — Minor update available for module ai (1.2.14). node_revision_delete 2.0.3 — Minor update available for module node_revision_delete (2.0.3).
← All modules

paragraphs_usage_manager

No security coverage
View on drupal.org

Stop editing Paragraphs field settings one by one. Paragraphs Usage Manager gives site builders a centralized way to control where paragraph types are allowed across entity types and bundles.

Paragraphs Usage Manager provides a centralized administration UI to manage where paragraph types are allowed across fields and entity types.
Instead of manually editing every Paragraphs field configuration, the module adds both per-paragraph controls and a global permissions-style matrix, while keeping Drupal's native field configuration as the single source of truth.

Features

  • Adds a dedicated Manage usage tab on each paragraph type.
  • Adds a global permissions-style overview matrix to manage all paragraph usage from one screen.
  • Automatically discovers all entity_reference_revisions fields targeting paragraphs.
  • Works with any supported fieldable content entity type, including custom entities.
  • Supports nested paragraphs, so a paragraph can itself be a parent entity.
  • Lets administrators restrict discovery to selected entity types.
  • Applies differential updates: only the relevant paragraph bundle is added or removed, while other allowed bundles are preserved.
  • Supports both Paragraphs selection handler modes, including include and exclude configurations.
  • Keeps target_bundles_drag_drop in sync so widget configuration remains consistent.
  • Safely reports fields using custom or unsupported handlers as read-only instead of overwriting them.

This module is especially useful on large Drupal sites where many content types, custom entities, or nested paragraph structures make Paragraphs field maintenance repetitive and error-prone.

Post-Installation

  1. Install and enable the module.
  2. Grant the administer paragraphs usage manager permission to the appropriate administrator roles.
  3. Go to Administration » Configuration » Content authoring » Paragraphs Usage Manager and select which entity types should be scanned for paragraph reference fields.
  4. Save the configuration.

Once configured, the module can be used in two ways:

  • Per paragraph type: edit a paragraph type and open the Manage usage tab to decide in which parent fields it should be allowed.
  • Global overview: go to the global usage matrix to manage all paragraph types across all detected parent fields from a single screen.

The module does not create a new content type, field type, or text format. It works directly on existing Paragraphs field configuration.

Additional Requirements

  • Drupal 10 or Drupal 11.
  • PHP 8.1 or higher.
  • The Paragraphs module.

Recommended modules/libraries

No additional library is required.

This project is designed as an extension to the Paragraphs ecosystem, so it is most useful on sites that already rely heavily on Paragraphs for structured content building.

Similar projects

Drupal core and Paragraphs already let administrators choose which paragraph types are allowed on each field, but that configuration is field-by-field.
Paragraphs Usage Manager focuses on the administrative experience of managing those relationships centrally, with both a per-paragraph usage screen and a global matrix overview.

Its main differentiators are:

  • A centralized overview instead of editing each field manually.
  • Support for multiple entity types, including custom entities.
  • Support for nested paragraphs.
  • No duplicated configuration: native field settings remain the only source of truth.

Supporting this Module

Bug reports, issue reviews, testing feedback, and patches are welcome through the project issue queue.

Community Documentation

Project documentation can be added here over time, including walkthroughs, examples, or demo links.

Activity

Total releases
1
First release
Apr 2026
Latest release
21 hours ago
Release cadence
—
Stability
100% stable

Releases

Version Type Release date
1.0.0 Stable Apr 20, 2026