If your custom taxonomy isn’t visible in WordPress admin, it’s likely due to configuration errors or conflicts. The issue often stems from:
- Incorrect settings in
register_taxonomy()(e.g.,show_ui,show_in_restnot set totrue). - Missing link between taxonomy and post type.
- Slug formatting issues (e.g., spaces, special characters, or overly long slugs).
- Plugin or theme conflicts that interfere with taxonomy display.
- Caching problems preventing updates from showing.
Quick Fixes:
- Check Your Code: Ensure
register_taxonomy()includesshow_ui,show_admin_column, andshow_in_restset totrue. - Link Taxonomies Correctly: Taxonomies must be registered after their associated post types.
- Validate Slugs: Use short, lowercase slugs with hyphens only.
- Test for Conflicts: Temporarily switch to a default theme and disable plugins to identify the source.
- Clear Cache: Reset caching plugins, browser cache, and permalinks.
These steps typically resolve most display issues. For advanced cases, ensure hierarchical taxonomies are configured properly or check compatibility with tools like Gutenberg, ACF, or page builders. Always test changes thoroughly to avoid breaking functionality.
How to show custom taxonomy value in the admin screen with and without plugin
Why You Can’t See Custom Taxonomies in Admin
If your custom taxonomies are not showing up in the WordPress admin, finding out why can save you a lot of time and stress. The main causes are often simple errors that are quick to fix once you spot them.
Wrong register_taxonomy() Settings
Wrong settings in the register_taxonomy() function can make taxonomies disappear. Look closely at these main parts: show_ui, show_admin_column, and, for Gutenberg users, show_in_rest.
For the block editor (Gutenberg), show_in_rest must be true. Without this, your taxonomy won’t work in the block editor, even if it shows up in other places.
Here’s how wrong settings impact your taxonomy:
- No
show_ui: The taxonomy won’t appear in the admin. - No
show_admin_column: You won’t see the taxonomy column in post list views. - No
show_in_rest: The taxonomy won’t work with the Gutenberg editor.
After checking these settings, make sure your taxonomy is rightly linked to its post type.
Taxonomy Not Linked to Post Type
For a custom taxonomy to be seen, it must be linked to a post type. This link tells WordPress where the taxonomy is meant to be shown.
Two main problems can mess with this link:
- The taxonomy is not given to any post type.
- Post types are set up after their taxonomies, which messes up the link. Always set up post types before taxonomies.
For example, if you make a custom post type called "Products" and a taxonomy called "Product Categories", but don’t link them right, the taxonomy won’t show when you edit products. Fixing this link makes sure the taxonomy shows as it should.
Slug Issues
Badly formatted taxonomy slugs can quietly mess up the display. WordPress has clear rules for slugs, and not following them can cause trouble.
Here are common slug mistakes:
- Using spaces or odd characters.
- Conflicts with existing WordPress words.
- Slugs that are too long.
Slugs should be short, lowercase, and use hyphens instead of spaces or underscores. For instance, don’t use a slug like "product categories & types." Instead, use "product-categories-types."
Plugin or Theme Conflicts
Plugins or themes can sometimes mess with how taxonomies are set up or shown. This happens when many plugins try to control the same admin parts or when themes change what WordPress usually does.
Here are some usual sources of conflicts:
- Plugins that turn off or hide taxonomies from admin screens.
- Page builders or admin tweak plugins.
- Tools like Advanced Custom Fields (ACF), which might deal with custom taxonomies in a way that hides them from menus or filters.
To find the issue, switch to a basic WordPress theme, like Twenty Twenty-Four, and turn off all plugins except the one that sets up your taxonomy. If the taxonomy comes back, you’ve found a conflict. Now, you can find and fix the problem.
Caching Issues
Caching is another big reason why updates to taxonomy might not show in the admin. WordPress object caching, plugin-based caching, and even browser caching can all block updated settings.
When you change your code for sorting data, old saved data might stop your new changes from showing right away. Saving objects and extra plugins from others often cause this [5]. To fix this, clear all saved data – on both the server and in your web viewer. This step tends to solve the problem.
How to Fix Issues with Custom Taxonomy Not Showing
This part tells you how to fix it when custom taxonomies don’t show up right in your WordPress control panel. Main settings like show_ui, show_admin_column, and show_in_rest are key in controlling if you can see the taxonomy.
Look at Your Taxonomy Set Up Code
First, check the register_taxonomy() function in your code. If you set up the taxonomy right, it might look like this:
register_taxonomy('genre', 'book', array( 'label' => 'Genres', 'show_ui' => true, 'show_admin_column' => true, 'show_in_quick_edit' => true, 'show_in_rest' => true, 'hierarchical' => true, 'public' => true, )); These options do the following:
show_ui: This lets the taxonomy show up in the admin menu.show_admin_column: This puts the taxonomy in a column on post lists.show_in_quick_edit: This lets you change taxonomy terms fast in quick edit.show_in_rest: This makes the taxonomy work with the Gutenberg editor.
If any options are not set or are set to false, your taxonomy won’t show up where it should. Change your code, save the file, and see if the taxonomy shows.
Check How You Set Up Taxonomies
For a taxonomy to be right in the admin, it must link to a post type. Make sure it’s linked to the correct one.
register_taxonomy('genre', 'book', $args); One key thing is how you set up your work. You must add your post types first, then your taxonomies. Why? If you add taxonomies first, WordPress might not link them right. To dodge this, run your register_post_type() code first, then register_taxonomy() or tweak your init hook order.
Set Slug Right: Length and Shape
WordPress has clear rules about taxonomy slugs. A user once said a taxonomy didn’t show up because its slug was too long (over 30 letters). Cutting it down fixed it [6].
Stick to these slug tips:
- Keep it short, under 30 letters.
- Use only small letters, numbers, and lines.
- Skip spaces, odd marks, or words like "post", "page", or "category."
Want to tweak an old slug? Be slow and careful. Such changes can mess up your taxonomy links. To keep things safe, try a database change script or a plugin. After you edit, check for any clashes with themes or plugins.
Fix Plugin or Theme Fights
Plugin or theme wars can also mess up how taxonomies show. To find where the problem is, try these steps:
- Flip to a basic WordPress theme, like Twenty Twenty-Four. If the taxonomy shows up now, your theme might be the issue. Check the
functions.phpfile for weird code. - If it’s still broken, turn off all plugins but the one you use for your taxonomy. Turn them back on one by one to spot the trouble. The plugin you add back right before the error pops up is the problem.
Usual trouble spots are:
- Admin change plugins that hide stuff.
- Page makers that shift admin screens.
- Field handlers like Advanced Custom Fields.
- Cache plugins messing with admin pages.
Find a bad plugin? Look at its settings, mainly those about taxonomies or admin menus. Clear any cache after changes to make sure things are fixed.
Clear Cache and Make Links New
Sometimes, old cache data hides your changes. To clean it up:
- Wipe your caching plugin’s cache. Look in the admin menu for a reset option on tools like WP Rocket, W3 Total Cache, or WP Super Cache.
- Clear your web browser cache. Try Ctrl+F5 or Cmd+Shift+R on Mac for a full reset, or just wipe the cache.
- Refresh your links in Settings > Permalinks on WordPress. Hit "Save Changes" without making other changes to reset rules.
If your server uses Redis or Memcached, talk to your hosting service for help on clearing those caches.
One user noted their taxonomy didn’t show up because all posts were drafts. Publishing some posts made the filter appear [4]. This shows how missing content can hide display issues.
After you clear the cache and reset the links, go back to your admin area. You should now see your custom group in the places you look for it.
sbb-itb-77ae9a4
Big Fixes for Tough Issues
After you deal with the usual problems, there might still be times when you need deep fixes. These big fixes help with hard cases that are not just the simple stuff.
Fix Levels of Grouping Display
Handling levels of groupings with top and lower terms in WordPress can be hard, more so when the admin area does not show the setup right. Instead of showing levels, it might just list all as one line, even if the links are set right.
To fix this, make sure the ‘hierarchical’ setting is on and that top labels are easy to see. Here’s a way to do it:
register_taxonomy('product_category', 'product', array( 'hierarchical' => true, 'show_ui' => true, 'show_admin_column' => true, 'show_in_quick_edit'=> true, 'show_in_rest' => true, 'public' => true, 'labels' => array( 'name' => 'Product Categories', 'singular_name' => 'Product Category', 'parent_item' => 'Parent Category', 'parent_item_colon' => 'Parent Category:', ), )); If you set 'hierarchical' => true and add tags for main items, it makes the order clear in the admin spot. Turning on 'show_admin_column' also puts the order right in the admin rows.
For more big plans, you need to make sure it works with other tools.
Make Taxonomies Go with Plugins and Tools that Make Pages
Tools such as Advanced Custom Fields (ACF) and Meta Box may have issues with new taxonomies if they’re not set up soon enough in WordPress’s start-up. For example, ACF needs taxonomies ready before it sets up its fields. If your taxonomy isn’t set up in time, things like wp_get_object_terms() and get_terms() might break.
To stop these problems:
- Set up your taxonomy early on, before ACF or like plugins start.
- Make sure ACF fields are set to match the right taxonomy tag.
- Check that your taxonomy links to the right post type.
For users of Meta Box, ensure the taxonomy is set before linking it to your custom post types. If terms don’t show on the edit page, it might be because the taxonomy isn’t right set to the planned post type.
Tools to build pages, like Elementor, Bricks, and Oxygen, need taxonomies to be seen through the WordPress REST API. To make sure they work, include 'show_in_rest' => true in your taxonomy setup. If this isn’t done, the page builder might not pull taxonomy info for live content or sorting traits. If you still have problems, check that the taxonomy is set early enough in the WordPress run, before other plugins or page builders start.
Set Up REST API for Gutenberg
The Gutenberg editor uses the WordPress REST API to get to custom taxonomies. If your taxonomy isn’t shown right via the REST API, it won’t be seen in Gutenberg’s taxonomy panels or live blocks.
To link your taxonomy with Gutenberg, put 'show_in_rest' => true in your register_taxonomy() call. You can also set a custom 'rest_base' if needed:
register_taxonomy('article_topic', 'post', array( 'show_in_rest' => true, 'rest_base' => 'topics', 'rest_controller_class'=> 'WP_REST_Terms_Controller', 'show_ui' => true, 'show_admin_column' => true, 'hierarchical' => true, )); If you see taxonomy terms in the REST API, but not in Gutenberg’s picker, there might be a problem with how the taxonomy links to post types. Look again at the second part in your register_taxonomy() function to make sure it names the right post type. For taxonomies used with many post types, either set up the taxonomy for each post type on its own, or give an list of post types. This makes everything work well and easy to use in your setup.
Get More WordPress Help from WP Winners
Having trouble with custom taxonomy issues? You’re not alone – it’s just one of the many problems WordPress users have. After handling taxonomy display issues, WP Winners has loads of help for you to get over other common WordPress problems. Check out our detailed guides for real answers.
Look At Tutorials and Guides
WP Winners has step-by-step guides on everything from making taxonomies to fixing tough plugin issues. These guides aim to spot problems and fix them fast, often with checklists to help you avoid long hours of trouble.
These resources are great because they mix deep tech info with clear, user-friendly advice. Whether you’re new and need help with register_taxonomy() or you need expert tips on using the REST API with Gutenberg, we have help for all. Many guides also have tips for working with popular tools like Elementor and Bricks, which make them useful for many ways of working.
Want more regular tips? Keep reading to hear about our newsletter.
Sign Up for the WP Winners Newsletter
For news and expert tips right to your email, try the WP Winners newsletter. It’s full of useful tips, including security updates and ways to make things work better so you can stop problems before they start.
This newsletter is vital, especially since over 60% of WordPress users run into issues with custom post types and taxonomies at least once a year, as seen in the 2024 WordPress.org Community Survey.
Subscribers can also help pick what we write about. You can suggest ideas or share problems you want help with, making sure our guides meet real needs of WordPress users – not just general advice.
With the WP Winners newsletter, you’ll be ready for anything from taxonomy issues to big site changes. Best of all, the tips are easy to use in your projects right away.
Conclusion
Fixing custom taxonomy display issues in the WordPress admin area is entirely doable. The usual suspects behind such problems include incorrect register_taxonomy() settings, missing links between taxonomies and post types, or conflicts caused by plugins or themes that interfere with the admin interface.
To tackle these issues, start by double-checking your code settings. Next, disable any conflicting plugins, switch to a default WordPress theme, clear the cache, and reset permalinks. These steps can help you pinpoint the root of the problem quickly and ensure WordPress updates its rewrite rules, so your taxonomy changes are applied correctly [1][2][3].
While these basic fixes often resolve common issues, more advanced scenarios – like hierarchical taxonomies or page builder integrations – may require additional techniques. This guide includes solutions for such cases to help you maintain smooth functionality across various WordPress setups.
For both simple and complex fixes, WP Winners provides a wealth of resources. From detailed tutorials to expert advice, they’ve got everything you need to handle WordPress challenges effectively.
"At WP Winners, we harness the power of artificial intelligence to bring you the latest tips, tricks, tutorials, and valuable resources tailored for WordPress users and developers. Our AI-driven approach ensures that we deliver up-to-date and relevant content to help you navigate and excel in the WordPress ecosystem."
– WP Winners [7]
FAQs
Why isn’t my custom taxonomy showing up in the WordPress admin panel, even though I’ve configured register_taxonomy()?
If your custom taxonomy isn’t showing up in the WordPress admin panel, it’s likely due to a misconfiguration in the register_taxonomy() function. Here are the key settings you should review:
- ‘show_ui’: Make sure this is set to
true. Without it, the taxonomy won’t appear in the admin area. - ‘show_in_menu’: This should also be set to
true, so the taxonomy is accessible through the admin menu. - Post Type Association: Double-check that the taxonomy is properly linked to the intended post type within the
register_taxonomy()function.
Once you’ve verified these settings, clear your site’s cache and refresh the admin panel. If the problem continues, it’s worth examining your theme or plugin code to rule out conflicts. For more tips and tools to improve your WordPress setup, visit WP Winners – a resource hub designed to help you get the most out of WordPress.
Why isn’t my custom taxonomy showing in the WordPress admin panel, and how can I fix it?
If your custom taxonomy isn’t showing up in the WordPress admin panel, it’s likely due to an issue with how it’s registered or a conflict with a plugin or theme. Start by double-checking your register_taxonomy function. Make sure you’ve included the right arguments, like 'show_ui' => true and 'show_in_menu' => true. Even a small typo or a missing parameter can prevent the taxonomy from appearing.
If everything looks correct in your code but the problem persists, try deactivating your plugins one at a time to see if there’s a conflict. You can also switch to a default theme, like Twenty Twenty-Three, to determine if your theme is causing the issue. Once you identify the source of the conflict, you can update or replace the problematic plugin or theme.
For more WordPress tips and solutions, check out resources like WP Winners, which offers expert advice to help you get the most out of your site.
Why isn’t my custom taxonomy showing up in the WordPress admin area, even after clearing the cache and resetting permalinks?
If your custom taxonomy still isn’t showing up in the WordPress admin area after clearing the cache and resetting permalinks, there are a few more steps you can take to figure out what’s going wrong:
- Double-check your taxonomy registration code: Ensure that the
register_taxonomy()function is set up correctly in your theme or plugin. Pay special attention to parameters likeshow_in_menuandshow_ui– both should be set totrueif you want the taxonomy to appear in the admin area. - Review user permissions: Confirm that the current user role has the right permissions to view or manage the taxonomy. If not, you may need to update the capabilities in your code.
- Test for plugin conflicts: Deactivate other plugins temporarily to see if one of them might be causing the issue. Sometimes, conflicts between plugins can interfere with taxonomy visibility.
- Enable debugging mode: Turn on WordPress debugging to identify any errors that could help pinpoint the problem.
Working through these steps should solve most issues with custom taxonomy visibility. For more WordPress tips and expert advice, check out resources like WP Winners, which provides tools and insights for users at every skill level.