taxonomy_usage
The Taxonomy Usage module provides comprehensive detection of taxonomy term usage across all entity types and fields, preventing accidental deletion of terms that are still referenced in content.
Features
- Automatically finds taxonomy term usage across all entity types and fields, not just nodes
- Prevents accidental deletion of taxonomy terms that are still in use, with detailed usage reports
- Detects usage in both published content and draft revisions
- Provides detailed usage information with direct links to content
Note: The module includes smart handling of parent-child relationships in taxonomies through its getTermUsageWithChildren() method. When you attempt to delete a parent term, the module doesn't just check if that specific term is in use – it also checks all of its child terms.
Post-Installation
- Visit /admin/config/taxonomy/usage to configure the module settings:
- Enable/disable deletion prevention
- Choose which entity types to check
- Set maximum results to display
- Configure draft content checking
- When viewing taxonomy terms, you'll see:
- A new "View usage" operation link next to each term
- Detailed usage information when attempting to delete terms in use
- Prevention of deletion with helpful error messages
-
The module automatically:
- Intercepts taxonomy term deletion attempts
- Displays usage information before allowing deletion
- Prevents deletion of terms that are still in use
Additional Requirements
Integration with Taxonomy Manager: If you use the Taxonomy Manager module, usage information will automatically appear in bulk deletion forms.
Recommended modules/libraries
- Paragraphs Module: When enabled, the module provides full support for paragraph entities, including parent entity linking and draft paragraph detection
- Taxonomy Manager: Enhanced bulk operations with usage information displayed in deletion forms
This module was created with the assistance of AI technology to accelerate development and ensure comprehensive documentation and code quality.