Skip to content


Subversion checkout URL

You can clone with
Download ZIP
WordPress plugin which allows you to list posts from a category into a post/page using the [catlist] shortcode.

List Category Posts

Code Climate Travis CI

List Category Posts is a WordPress plugin that allows you to list posts from a category into a post/page using the [catlist] shortcode. This shortcode accepts a category name or id, the order in which you want the posts to display, and the number of posts to display. You can use [catlist] as many times as needed with different arguments.

Usage: [catlist argument1=value1 argument2=value2]

Please visit the plugin's page on to find out more.

Want to help with the development?

The evolution of this plugin wouldn't be possible without the help of these awesome contributors. Special thanks to Sophist and bibz for the hard work :+1:

Currently the plugin is mostly being developed through code contributions by its users. If you know PHP and would like to start contributing to the plugin, let me know! I can help you get started. Contact me here.


A Vagrantfile is provided to set up a box for WordPress development. You need Vagrant installed on your computer.

Fork the repo, clone it locally and do vagrant up. You'll have a WordPress instance running on

Install WordPress from that URL with this information:

  • Database Name: wordpress
  • User Name: wordpressuser
  • Password: wordpresspass

Activate the plugin on

The plugin code is linked directly on the box, so any change you make on the code is reflected automatically on the Vagrant box's WordPress.


[catlist argument1=value1 argument2=value2]

Support the plugin

If you've found the plugin useful, consider making a donation via PayPal or visit my Amazon Wishlist for books or comic books :)



List Category Posts

Copyright (C) 2008-2015  Fernando Briano (email :

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <>.
Something went wrong with that request. Please try again.