Title: List categories
Author: Fernando Briano
Published: <strong>26 Jun 2014</strong>
Last modified: 15 Mei 2025

---

Search plugins

![](https://ps.w.org/list-categories/assets/banner-772x250.png?rev=2517918)

![](https://ps.w.org/list-categories/assets/icon-256x256.png?rev=2517918)

# List categories

 Oleh [Fernando Briano](https://profiles.wordpress.org/fernandobt/)

[Download](https://downloads.wordpress.org/plugin/list-categories.0.5.zip)

 * [Details](https://ms.wordpress.org/plugins/list-categories/#description)
 * [Reviews](https://ms.wordpress.org/plugins/list-categories/#reviews)
 *  [Pemasangan](https://ms.wordpress.org/plugins/list-categories/#installation)
 * [Pembangunan](https://ms.wordpress.org/plugins/list-categories/#developers)

 [Support](https://wordpress.org/support/plugin/list-categories/)

## Description

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](https://developer.wordpress.org/reference/functions/wp_list_categories/)
WordPress function. This means given any of the [parameters](https://developer.wordpress.org/reference/functions/wp_list_categories/#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](https://developer.wordpress.org/reference/functions/wp_list_categories/)
for usage.

### Markup and Styling of Category Lists

Taken from the [wp_list_categories official documentation](https://codex.wordpress.org/Template_Tags/wp_list_categories#Markup_and_Styling_of_Category_Lists).

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](https://www.w3.org/TR/css-multicol-1/).
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.

## Reviews

![](https://secure.gravatar.com/avatar/482136856e04a4a542b2abf1dd58b9940866ef85b9b068a3bd246ebcb9f3fcf7?
s=60&d=retro&r=g)

### 󠀁[Simple, but effective](https://wordpress.org/support/topic/simple-but-effective-192/)󠁿

 [amedeebulle](https://profiles.wordpress.org/amedeebulle/) 24 Julai 2023

I was looking for a way to list subcategories of a single main category.This plugin
does the trick (and more)

![](https://secure.gravatar.com/avatar/a08c238554a6afbd5044e701cd90d6de4750750abf1a42f111dd2d2e1e101c9b?
s=60&d=retro&r=g)

### 󠀁[Easy and useful](https://wordpress.org/support/topic/easy-ans-useful/)󠁿

 [robegb](https://profiles.wordpress.org/robegb/) 25 Mei 2023

Well documented. Thank you!

![](https://secure.gravatar.com/avatar/f765533d2960b16b63a25d81ac174ff0715ca9909f776bc06f02568464113194?
s=60&d=retro&r=g)

### 󠀁[Just what I needed](https://wordpress.org/support/topic/just-what-i-needed-1221/)󠁿

 [Chris Roberts](https://profiles.wordpress.org/artcop1/) 6 Oktober 2022

Thank you for the great plugin! It works perfectly with WP v6.0.2 and my Hello Theme
and has saved me hours of work 🙂 Cheers!

![](https://secure.gravatar.com/avatar/a595552ff5cd7857473a8647d632907843460520a876a57ae10a1e69512e4576?
s=60&d=retro&r=g)

### 󠀁[Thank you!!](https://wordpress.org/support/topic/thank-you-3207/)󠁿

 [bigcheesez](https://profiles.wordpress.org/bigcheesez/) 2 Oktober 2022

i hope these great works bless you with future work and good fortune. thank you 
kindly. oh and i tested this and works fine!

![](https://secure.gravatar.com/avatar/afdd4b8d340742bec36a31c07e86a2e938554e3394ab0681ba227a1809c2dc0b?
s=60&d=retro&r=g)

### 󠀁[not to use](https://wordpress.org/support/topic/not-to-use/)󠁿

 [orangesunshine](https://profiles.wordpress.org/orangesunshine/) 30 Mac 2018

could not find out out how to use it.

![](https://secure.gravatar.com/avatar/3cc94764dae0b65e80eabf23c7b299f3da208a8c6da848b92a18936da09d86e1?
s=60&d=retro&r=g)

### 󠀁[Works as promised](https://wordpress.org/support/topic/works-as-promised-67/)󠁿

 [Mel – Jett Web Development](https://profiles.wordpress.org/melr/) 16 November 
2016

Thank you, perfect solution in minutes!

 [ Read all 15 reviews ](https://wordpress.org/support/plugin/list-categories/reviews/)

## Contributors & Developers

“List categories” adalah perisian sumber terbuka. Orang-orang berikut telah menyumbang
kepada pemalam ini.

Penyumbang

 *   [ Fernando Briano ](https://profiles.wordpress.org/fernandobt/)

[Translate “List categories” into your language.](https://translate.wordpress.org/projects/wp-plugins/list-categories)

### Berminat dalam pembangunan?

[Layari kod](https://plugins.trac.wordpress.org/browser/list-categories/), periksa
[repositori SVN](https://plugins.svn.wordpress.org/list-categories/), atau langgani
[log pembangunan](https://plugins.trac.wordpress.org/log/list-categories/) dengan
[RSS](https://plugins.trac.wordpress.org/log/list-categories/?limit=100&mode=stop_on_copy&format=rss).

## 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](https://github.com/picandocodigo/List-Category-Posts/issues/106)

## Meta

 *  Version **0.5**
 *  Last updated **1 tahun lalu**
 *  Active installations **5,000+**
 *  WordPress version ** 3.3 or higher **
 *  Tested up to **6.8.5**
 *  Language
 * [English (US)](https://wordpress.org/plugins/list-categories/)
 * Tags
 * [categories](https://ms.wordpress.org/plugins/tags/categories/)[cms](https://ms.wordpress.org/plugins/tags/cms/)
   [list](https://ms.wordpress.org/plugins/tags/list/)
 *  [Paparan Lanjutan](https://ms.wordpress.org/plugins/list-categories/advanced/)

## Ratings

 4.5 out of 5 stars.

 *  [  11 5-star reviews     ](https://wordpress.org/support/plugin/list-categories/reviews/?filter=5)
 *  [  3 4-star reviews     ](https://wordpress.org/support/plugin/list-categories/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/list-categories/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/list-categories/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/list-categories/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/list-categories/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/list-categories/reviews/)

## Penyumbang

 *   [ Fernando Briano ](https://profiles.wordpress.org/fernandobt/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/list-categories/)

## Derma

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://picandocodigo.net/programacion/wordpress/list-category-posts-wordpress-plugin-english/#support)