List categories
Simple plugin to display categories in any post or page with a shortcode.
Safe pick
Yes — List categories is a safe, well-maintained plugin to use in 2026. It runs on 5K+ sites, is rated 4.5/5 and was last updated 2 months ago, and scores 82/100 on our health check.
- Tested with the latest WordPress (7.1)
- Momentum — downloads up 44.3% vs the previous 30 days
How does it stack up?
Side-by-side on installs, updates, ratings & supportDaily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where List categories stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| categories | #1 |
| cms | #14 |
| list | #4 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 4.5 from 15 reviews
About List categories
From the official readme · v0.5Description
Simple plugin to display categories in any post or page with a shortcode. It’s basically a shortcode API interface to the wp_list_categories WordPress function. This means given any of the parameters accepted by the function, you can pass it in as a shortcode parameter to the categories shortcode.
Usage:
[categories orderby=count]
Will display links to all the categories and order them by number of posts in each category.
You can also list tags or any other WordPress taxonomy. You need to pass a value to the taxonomy parameter. For example to list tags: [categories taxonomy=post_tag title_li="Tags"].
By default, the usage shows:
- No link to all categories
- Sorts the list of Categories by the Category name in ascending order
- Displayed in an unordered list style
- Does not show the post count
- Displays only Categories with posts
- Sets the title attribute to the Category Description
- Is not restricted to the child_of any Category
- No feed or feed image used
- Does not exclude any Category and includes all Categories
- Displays the active Category with the CSS Class-Suffix ‘ current-cat’
- Shows the Categories in hierarchical indented fashion
- Display Category as the heading over the list
- No SQL LIMIT is imposed (‘number’ => 0 is not shown above)
- Displays (echos) the categories
- No limit to depth
- All categories.
- The list is rendered using a new walker object of the the Walker_Category class
See wp_list_categories for usage.
Markup and Styling of Category Lists
Taken from the wp_list_categories official documentation.
By default, wp_list_categories() generates nested unordered lists (ul) within a single list item (li) titled “Categories”.
You can remove the outermost item and list by setting the title_li parameter to an empty string. You’ll need to wrap the output in an ordered list (ol) or unordered list yourself (see the examples above). If you don’t want list output at all, set the style parameter to none.
You can style the output with these CSS selectors :
li.categories { ... } /* outermost list item */
li.cat-item { ... }
li.cat-item-7 { ... } /* category ID #7, etc */
li.current-cat { ... }
li.current-cat-parent { ... }
ul.children { ... }
For instance, you can remove the bullet points next to each category with:
.cat-item {
list-style-type: none
}
Show categories list in columns
For outputting the list into columns, you can use CSS’s multicolumns. Since by default the list is printed as an unordered list with the “categories” class, you can add this to your CSS:
.categories{
column-count: 5;
column-gap: 50px;
}
Installation
- Upload the plugin’s directory into your wp-content/plugins/ directory.
- Login to your WordPress Admin menu, go to Plugins, and activate it.
Changelog
0.4
- Tested up to the latest version of WordPress.
0.3
- Tested up to the latest version of WordPress
- Adds note about taxonomies, updates parameters
0.2
- Fixes plugin content with wrong placement. Thanks windwww from the WP Forums.
0.1
- First version based on this GitHub issue
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best List categories alternatives
All categories plugins →FAQ
List categories: quick answers
Straight answers, pulled from live WordPress.org data.
Source: WordPress.org
Is List categories free?
Yes. List categories is free to download and use from the official WordPress.org plugin directory.
Is List categories safe to use in 2026?
Yes — List categories is a safe, well-maintained plugin to use in 2026. It runs on 5K+ sites, is rated 4.5/5 and was last updated 2 months ago, and scores 82/100 on our health check.
How many websites use List categories?
List categories is active on 5K+ WordPress websites and has been downloaded 78,893 times since it launched in June 2014. It was downloaded 828 times in the last 30 days.
Does List categories work with WordPress 7.1?
Yes. The developer has tested List categories up to WordPress 7.1.5, the latest release. It requires WordPress 3.3 or newer.
When was List categories last updated?
The latest version, 0.5, was released on September 13, 2026 (2 months ago).
Who makes List categories?
List categories is developed and maintained by Fernando Briano.
What are the best alternatives to List categories?
The most popular alternatives to List categories are List category posts (70K+ installs), Media Library Assistant (70K+ installs) and PublishPress Taxonomies (40K+ installs).
Powered by PageForge
One template and a spreadsheet. A real page for every search.
PageForge turns each row of a CSV into a WordPress page with its own title, URL, SEO fields and schema, built on the layout you already designed. Free on WordPress.org.
- CSV and XLSX, plus Google Sheets on Professional and Enterprise
- Its own title, URL, SEO fields and schema for every page
- Works with the block editor, Elementor, Divi and Avada
- Free on WordPress.org, no credit card
