Taxonomy Usage
This module helps prevent accidental deletion of taxonomy terms by tracking where they are used across all content types and fields. It provides detailed usage reports and blocks deletion if a term is still referenced, even in draft content.
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.