Paragraphs Usage Manager

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.3 || ^11.0
• PHP: ^8.1.
• 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.

AI usage disclosure

AI-Generated: Yes. An AI assistant was used to help draft parts of this module's code, automated tests, and CI/tooling configuration.

All AI-assisted changes were reviewed, tested, and validated by the maintainer, who takes full responsibility for them, including their compatibility with the GPL license.