This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Taxonomy List Shortcode


The Taxonomy List Shortcode plugin adds a shortcode to your WordPress installation which enables you to display multiple unordered lists containing every term of a given taxonomy.

Adding [taxonomy-list] to your post content will render a set of three unordered lists containing all terms of a given taxonomy. Custom css will be printed in a style tag to the head of every page view. If this is unacceptable to you, you may turn it off by using the checkbox labeled “Enable CSS” under the “Taxonomy” section of “Settings” in the Administration Panels.

Supported Parameters

  1. tax To define the taxonomy that you would like to list terms from, you will need to specifiy the name of the taxonomy in the tax parameter: [taxonomy-list tax="category"]. In an “out-of-the-box” installation of WordPress, the following taxonomies will be recognized: post_tag, category, and link_category. If you have defined custom taxonomies through use of a plugin or your own hacker-skillz, you can use the name of this taonomy as well: [taxonomy-list tax="fishy-squiggles"]. If the taxonomy cannot be located, due to a spelling error or missing code, the [taxonomy-list] shortcode will return an empty string.

  2. cols To define the number of columns that the [taxonomy-list] shortcode generates, you will want to use the cols parameter. This parameter will accept an integer from 1 – 5. If this parameter is left empty, or a value outside of it’s range is defined, it will default to three columns. Example: [taxonomy-list tax="category" cols="4"].

  3. color Use this to define the color of the text. The color passed should be in hexidecimal notation (ff0000) or short hand (f00) Please do not include the hash character (#).

  4. background Use this to define the color of the background. The color passed should be in hexidecimal notation (ff0000) or short hand (f00) Please do not include the hash character (#).

  5. show_counts (bool) If you would like to disable the counts from displaying after your term name, set this parameter to 0. Default value is 1.

  6. NEW! per_page (int) Using this parameter enables paging for your term list. It accepts a numerical value from 1 to “your hearts desire”. It is suggested that this feature only be activated on pages that display a list of terms from a single taxonomy. No need to worry, if you have 2 or more lists of terms on a page and you add the per_page parameter to both shortcodes, your site will not break. Please refrain from using this parameter on shortcodes within posts.


  1. Post Tags (default) [taxonomy-list] – Display a three column, list of Post Tags in alphetbetical order. Although this is the default usage, it is synonymous with [taxonomy-list tax="post_tag" cols="3"].

  2. Post Categories [taxonomy-list tax='category'] – Display a three column, unordered list of Post Categories.

  3. Link Categories [taxonomy-list tax='link_category'] – Display a three column, unordered list of Link Categories. Special note: it is rather pointless to use link categories do to the fact that WordPress does not support front-end display of individual links.

  4. Custom Taxonomy [taxonomy-list tax="fishy-squiggles"] – Display a three column, unordered list of the custom taxonomy “fishy-squiggles”.

  5. Two Columns [taxonomy-list cols="2"] – Display a two, horizontally-aligned unordered lists of Post Tags.

  6. Five Columns (maximum) [taxonomy-list cols="5"] – Display a 5, horizontally-aligned unordered lists of Post Tags.

  7. Custom Taxonomy with 5 Columns [taxonomy-list tax="fishy-squiggles" cols="5"] – Display 5, horizontally-aligned unordered lists of the custom taxonomy “fishy-squiggles”.

Notes on post status

  • Terms containing published, password protected posts will be shown in the list.
  • Terms containing only private, scheduled, draft or posts pending review will not be displayed in the list.

The XHTML + CSS was Tested in the Following User Agents

  • Windows XP: Internet Explorer 6
  • Windows XP: FireFox 3.5.3
  • Windows XP: FireFox 3.6.3
  • Windows XP: Opera 9.26
  • Windows XP: Safari 4.0.3

This Plugin has been tested with the Following WordPress Themes


  • This is the output of the shortcode when set to display the terms of custom taxonomy "Topics".
  • Same view as above, but when you are logged in - edit links will display next to each term.


  1. Download
  2. Unzip the package and upload to your /wp-content/plugins/ directory.
  3. Log into WordPress and navigate to the “Plugins” panel.
  4. Activate the plugin.


Read all 3 reviews

Contributors & Developers

“Taxonomy List Shortcode” is open source software. The following people have contributed to this plugin.




  • Replaced is_taxonmy() with taxonomy_exists() for WordPress 3.0.
  • Defined taxonomy_exists() for 2.9 branch.
  • Added edit links to the terms lists.
  • show_all argument has been added to shortcode. It is set to false by default.
  • Tested in 3.0-RC3 using the TwentyTen theme.
  • Shortcode’s ‘args’ argument has been removed.
  • Pad counts is now always set to true for get_terms().


  • Fixed bug in form control for css toggle.


  • Added Support for paging via the per_page parameter.
  • Added cutom subpage under “Settings” called “Taxonomy” for 3.0 support. They killed “Miscelaneous” where our setting used to live.
  • Changed the name of the CSS setting in the database. Sorry, it won’t happen again 🙂


  • Allowed for disabling of term counts via the show_counts argument. Props to nicolas for the suggestion.


  • Added parameters for background and color.
  • CSS bug fixes.
  • Tested in 3.0 Beta.


  • Main plugin file’s name has been changed from “mf-taxonomy-list-shortcode.php” to “taxonomy-list-shortcode.php”.
  • Style tag has been optimized to only use one line when rendered.
  • No longer using an object.
  • Removed the include_css() function.
  • Added option for CSS. This can be Set under Miscellaneous -> “Enable CSS for Taxonomy List Shortcode Plugin”.
  • Added PhpDoc style comments to code.
  • Added “args” attribute to the shortcode.


  • pad_counts is now set to true by default for get_terms();


  • PHP Bugfix with empty array being passed to array_chunk().


  • Added the sanitize_cols() method.


  • Original Release – Works With: wp 2.8.6 + wp 2.9 beta 2.