User Taxonomy & Directory


The plugin offers a user-friendly solution to help you manage user taxonomies and create user directories on your WordPress site.

Key Features:

Easy Taxonomy Management: Register and manage user taxonomies effortlessly, providing structure to your user base without unnecessary complexity.
Admin users with the edit_users capability can assign or un-assign categories from the User profile page, made even more flexible with the ut_render_taxonomy_dropdown filter to modify the check.

Taxonomy Template Customization: Each taxonomy term generates its own archive featuring the list of assigned users. The plugin allows you to customize this template by simply creating a folder named template in your theme's root directory and add the custom template user-taxonomy-template.php."
Make sure to refresh your permalinks after creating a new taxonomy to ensure that the template functions correctly.

Dynamic User Lists: user-directory block allows you to display user lists based on roles, with a variety of customizable fields and filters for your front-end design.

User List Features:

Simple Search: Find users easily by name.

Filtering: Use taxonomies to refine user lists, with the option to activate multiple taxonomy filters via block settings.

Flexible Fields: User Name is included by default, but you can add more fields like Bio and Images, all configured with the block settings along with an option to filter it.

The plugin is compatible with multisite environment.

Mga Credit

Justin Tadlock


  • Taxonomy CRUD Screen.
  • Taxonomy Tax archive page.
  • Taxonomy Terms List.
  • User Directory Block output.


This plugin provides 1 block.

  • User Directory Allows you to select a user role and list out all users as a Directory with filter and search option.


  1. Upload the user-tags folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. To create new Taxonomy Go to User -> Taxonomy screen.


  1. What if Template is not working?
    Ans: You need to save permalinks after you create a new taxonomy for template to work properly.

Filters Available

  • ‘user_taxonomy_args’ => Filter the arguments for registering taxonomy.
  • ‘user_tags_directory_user_roles’ => Filter list of roles displayed in user-directory block
  • ‘user_tags_directory_fields’ => Filter list of fields available for user-directory block
  • ‘user_directory_limit’ => Number of users to display in Users List
  • ‘ut_render_taxonomy_dropdown’ => Whether to show/update Taxonomy dropdown on user profile.


Marso 22, 2023
Fantastic plugin – one of the very few to have the hard work done and allow for user taxonomies. Works really well managing on the frontend & backend.
Disyembre 25, 2021
Did nothing, LOL, it installs, but you can’t do anything with it. Tags did NOT show up in the user’s Sorting Column list, so there’s no real point to using it. LOL Also, you can NOT bulk add tags to user, but since Tags don’t appear in the Column List for sorting… well you get the point… unless. UPDATE! It’s also converting my PHP ‘ ” character to ASCII, not cool. lol
Setyembre 3, 2016
Hello Umesh, I have installed the user tag plugin – 1.2.6 There is one issue in plugin. When you change the name of any taxonomy and then try to go inside the taxonomy to add or remove tags, you can not enter. I have debugged and found the solution in. wp-content\plugins\user-tags\lib\class-ut-user-tags-list.php line 113 changed the line from $taxonomy_slug = ut_taxonomy_name( $item[‘name’] ); to $taxonomy_slug = ut_taxonomy_name( $item[‘slug’] );
Setyembre 3, 2016 1 reply
Nice, now I can save some user preferences.
Read all 13 reviews

Contributors & Developers

“User Taxonomy & Directory” is open source software. The following people have contributed to this plugin.




  • Refactored code for better readability and added functionality.
  • Registered Taxonomies are now displayed under Users menu.
  • Added Gutenberg block user-directory to create filterable user lists.

** Breaking Changes **
* Removed shortcode user_tags, user-tags-cloud along with front-end functionality of tags assignment.


  • Fixed: Updated filter name ‘ut_tepmplate_content’ => ut_template_content :
  • Fixed: Return $template variable in functions.php
  • Fixed: string to array conversion.
  • Fixed: Compat with WordPress >= 5.5 ( Fixed fatal error )
  • Updated: Switch to div instead of table for new User Taxonomy screen


  • Fixed – Fatal error, Initialise as array instead of string


  • New – Filter: ut_template_users in Taxonomy template to filter the list of users before displaying
  • Fixed – handle count callback for register taxonomy (Fixes tag cloud size issue )


  • Fixed – Remove PHP closures


  • Update – Taxonomy name is independent of prefix
  • Fixed – Bubbling up of multiple list on repeated click over most used tags link
  • Fixed – Tag being saved for admin too on editing other user profile

( Credits: @Tempera )


  • Fixed – ‘ut_template_content’ filter args
  • Fixed – Translation function (props @stefan)
  • Updated – Replaced PHP closure with normal functions


  • Fixed – Tag cloud not appearing for all taxonomies in shortcode
  • Update – Shortcode – Do not echo form if user is not loggedin


  • Fixed – Tag cloud for [user_tags] shortcode


  • Fixed – [user_tags] shortcode


  • Fix: All tag not being deleted


  • New: Tag Cloud to choose from most popular
  • New: Filter ‘ut_tag_cloud_heading’ to change tag cloud heading


  • Fixes Page not found error for tag templates
  • Fixes tags update for other users by administrator, causing overwrite to current logged in users taxonomy
  • Improved Template Styling


Fixes Taxonomy length error


Code formatting


First Release