Paragraph Usage Dashboard

Paragraph Usage Dashboard

Description:

Provides a powerful visual dashboard of Paragraph Types and where they are used, including icons, content types, and path aliases .

Key Features

• Visual Dashboard – Clean, intuitive interface showing paragraph usage at a glance
• Paragraph Type Icons – Displays configured icons for each paragraph type
• Content Type Usage – Shows which content types utilize each paragraph type
• Path Aliases Display – Lists actual URLs rather than numeric IDs
• Quick Access Links – Buttons for immediate navigation to entities
• Unused Paragraph Detection – Highlights paragraph types not used anywhere
• Advanced Filtering – Filter by paragraph name, path alias, or unused status
• Multi-Select Filter – Choose multiple paragraph types to display
• Path Search – Find paragraphs used on pages matching specific URL patterns
• Drill-Down Detail Views – See detailed instance-level usage
• Modern Architecture – Built using Drupal 11 OOP standards and services

Use Cases

• Content audits and cleanup
• Content migration planning
• Content strategy and governance
• Quality assurance
• Training for editors
• Maintenance — identifying unused paragraph types

Dashboard Features

The main dashboard (/admin/reports/paragraph-usage) includes:

• Icons for each paragraph type
• Clickable paragraph type names with usage badges
• List of content types using each paragraph type
• Human-readable path aliases of parent entities
• Link to detailed usage information

Filtering Options

• Show only unused paragraph types
• Search by paragraph type name
• Search by path alias
• Select specific paragraph types
• Persistent filters that stay active after refresh

Detail View

Clicking a paragraph type shows:

• Titles of entities using the paragraph
• Content type and bundle info
• Field name where the paragraph appears
• Path alias for each instance
• View links for each parent entity

Technical Highlights

• No database schema changes
• Optimized entity queries
• Service-based architecture
• Compatible with Drupal 11
• Accessible and responsive UI

Requirements

• Drupal 11
• Paragraphs module 1.x
• PHP 8.1+

Installation

1. Install via Composer: composer require drupal/paragraph_usage_dashboard
2. Enable the module: drush en paragraph_usage_dashboard
3. Grant the "Access paragraph usage dashboard" permission
4. Navigate to: Reports → Paragraph Usage

Permissions

access paragraph usage dashboard – Required to view dashboard and detail pages.

Architecture

• Services – Data collection via ParagraphUsageCollector
• Controllers – Dashboard and details
• Forms – Filter handling
• OOP Hooks – Modern attribute-based hooks
• Twig Templates – Themeable dashboard layout
• State API – Stores filter selections

Why This Module?

This module provides visibility into how paragraphs are distributed across a site — something Drupal does not do natively.