Inspecting Taxonomy Term Metadata
Introduction
WordPress taxonomies (categories, tags, and custom taxonomies) can also store metadata, just like posts. PureDevs Any Meta Inspector extends its functionality to taxonomy term edit screens, allowing you to view all metadata associated with any taxonomy term.
This is particularly useful when working with plugins that extend taxonomies with custom fields, such as WooCommerce product categories, Yoast SEO category metadata, or custom taxonomy fields added by themes and plugins.
Understanding Taxonomy Metadata
WordPress taxonomies are used to group and classify content. Common taxonomies include:
- Categories: Hierarchical organization for posts
- Tags: Non-hierarchical labels for posts
- Product Categories: WooCommerce product organization
- Product Tags: WooCommerce product labels
- Custom Taxonomies: Any custom classification system
Since WordPress 4.4, terms in any taxonomy can have metadata attached to them, stored in the termmeta database table.
Taxonomy metadata support was added in WordPress 4.4. If you’re using an older version, taxonomy term metadata won’t be available.
Accessing Taxonomy Term Metadata
To inspect metadata for any taxonomy term:
For Categories
- Navigate to Posts → Categories
- Click Edit on any category
- Scroll down on the term edit screen
- Look for the metadata display section
For Tags
- Go to Posts → Tags
- Click Edit on any tag
- View the metadata section on the edit screen
For Custom Taxonomies
- Navigate to your custom taxonomy in the admin menu
- Click Edit on any term
- The metadata inspector will display all associated metadata
For WooCommerce Product Categories
- Go to Products → Categories
- Edit any product category
- View category-specific metadata like thumbnail IDs, display settings, etc.
Common Taxonomy Term Metadata
Different plugins and themes add various types of metadata to taxonomy terms:
WooCommerce Product Categories
thumbnail_id– Category image attachment IDdisplay_type– How products should be displayedorder– Custom sort order
Yoast SEO
wpseo_title– SEO title for the termwpseo_desc– Meta descriptionwpseo_canonical– Canonical URLwpseo_noindex– Indexing settings
Advanced Custom Fields (ACF)
- Any custom fields added to taxonomy terms
- Image fields, text fields, relationship fields
- Repeater and flexible content fields
Custom Theme/Plugin Metadata
- Custom icons or images for terms
- Color schemes or styling options
- Featured content selections
- External IDs or API connections
Practical Use Cases
1. SEO Optimization
When working with SEO plugins:
- Verify SEO metadata is being saved correctly
- Check meta titles and descriptions
- Identify missing or incomplete SEO data
- Debug SEO plugin functionality
2. WooCommerce Category Management
For e-commerce sites:
- Verify category thumbnail IDs are correct
- Check display type settings
- Debug category page layout issues
- Understand how category data is structured
3. Custom Field Development
When developing custom taxonomy fields:
- Verify your custom fields are saving properly
- Check data format and structure
- Debug serialization issues
- Test field relationships and dependencies
4. Data Migration
During site migrations or redesigns:
- Identify all term metadata that needs migration
- Map old metadata keys to new structure
- Verify data integrity after migration
- Ensure no metadata is lost in transition
Working with Term Metadata
Metadata Display Format
The inspector displays term metadata similarly to post metadata:
- Meta Key: The field name/identifier
- Meta Value: The unserialized value
Unserialized Values
Complex metadata is automatically unserialized for easy reading:
- Arrays are displayed in readable format
- Nested structures are properly indented
- Object data is unpacked for inspection
When debugging category or tag issues on the frontend, inspecting term metadata can quickly reveal missing images, incorrect settings, or data corruption issues.
Tips & Best Practices
Finding the Metadata Section
On taxonomy term edit screens, the metadata display may appear:
- Below the term description field
- In a metabox on the right side
- At the bottom of the edit form
No Metadata Displayed?
If a term shows no metadata:
- The term genuinely has no custom metadata
- Only basic WordPress data exists (name, slug, description)
- Try viewing terms that have been customized with plugins
Hierarchical Taxonomies
For hierarchical taxonomies like categories:
- Each term has its own independent metadata
- Child terms don’t inherit parent metadata
- Metadata must be set individually for each term
PureDevs Any Meta Inspector is read-only. You can view term metadata but cannot edit it through this plugin. Use the appropriate custom fields interface or term edit screen to modify values.
Troubleshooting
Metadata not showing on term edit screen
- Verify you’re using WordPress 4.4 or higher
- Check that the plugin is activated
- Try editing a different term
- Clear browser cache and refresh
Partial or missing metadata
- The term may have limited custom data
- Check if the source plugin is still active
- Verify the metadata exists in the database
Incorrect or garbled data
- This indicates database corruption or plugin issues
- The inspector shows exactly what’s in the database
- Contact the plugin author for data structure issues
Was this article helpful?
Help us improve our documentation by providing feedback