Beginner's Guide for WordPress - Start your WordPress Blog in minutes.
Choosing the Best
WordPress Hosting
How to Easily
Install WordPress
WordPress Plugins
View all Guides

How to List Category Posts in a WordPress Post or Page with Shortcode

Last updated on by
Follow WPBeginner on YouTube
How to List Category Posts in a WordPress Post or Page with Shortcode

Have you ever found a need to list the posts from a specific category on a specific post or a page? In the past, we have used custom page templates and hard coded a solution in. However, recently we have discovered a way that allows you to list category posts in WordPress Posts or Page with a shortcode.

First thing you need to do is install and activate the List Category Posts plugin. Once you have activated the plugin, you can simply use the shortcode anywhere in your post or page.

The shortcode is [catlist] which accepts numerous parameters. First and foremost it accepts the category name or ID parameter. Example would be like:

[catlist name=tutorials]

If you want multiple categories, its best to use the IDs. The shortcode would look like this:

[catlist id=7,24,32]

The shortcode accepts bunch of other parameters including tags, orderby, order, numberposts, date, author, excerpt, excludeposts, comments, thumbnail, custom fields, etc. The full list of parameters can be found in the Other Notes section of the plugin.

The plugin also has a widget for the sidebar that you can use by going to Appearance » Widgets.

Download List Category Posts

Editorial Staff at WPBeginner is a team of WordPress lovers led by Syed Balkhi. Page maintained by Syed Balkhi.

WPBeginner's Video Icon
Our HD-Quality tutorial videos for WordPress Beginners will teach you how to use WordPress to create and manage your own website in about an hour. Get started now »
  • WPBeginner Staff

    Check out our guide on how to fix WordPress white screen of death.

  • Exnius

    Awesome trick, dudes. Thank you very much. I will use this in a recipes website.

    T h a n k y o u :D

  • Fabrizio

    can this be adapted to Pages? (I’ve already installed a plugin to make categories available to pages, too).


    • WPBeginner Support

      It should work with pages if you have enabled categories for pages.

  • Daniel

    Can anybody help me out to find out the way to know the shortcode to call only all the sub categories for a category on my blog well, waiting for the reply…..

  • Teresa

    I love this plugin! But, I do have a question. I’m trying to get the thumbnail image to display before the Post Title, and I cannot figure out how to do it. I’m sure there is some easy step that I am just missing, but I am drawing a blank. Any suggestions would be greatly appreciated!

    • WPBeginner Support

      Your theme’s category.php template should have the_thumbnail(); tag before or after the post title to display post thumbnail.

      <?php the_post_thumbnail(); ?>

      For more information see our guide on how to add post thumbnails or featured images in WordPress.

  • Pranjal

    Hello, is there a way to list all of the categories in a single page?

  • Umer Rock

    I want to list a specific Tag posts on a Page, is it possible

  • gabriel

    Hi, Thanks for this plugin it works great if I use it in the cms. But I want to use it on a template and ‘hard code it i’ I tried [catlist name=list] or how can I get it to work on a normal php page?

  • Dave Rozewski

    hey – i got it and it was really easy. Sorry to trouble you.


  • Dave Rozewski

    Hey it worked! Thanks. However what would be really useful if I could show a category of posts only on one page. Maybe this does that and I don’t know how.

    anyway, thanks.


  • Brad Paterson

    This is great. I have the plugin installed and it works well and is much easier than coding custom pages. Would be great to have the posts shown in more detail (e.g. thumbnails, excerpts etc) as can be done with custom coding a page too. Anyone found an easy way to do this?