Title: List category posts Author: Fernando Briano Published: غشت 16, 2008 Last modified: مارس 14, 2026 --- Search plugins ![](https://ps.w.org/list-category-posts/assets/banner-772x250.png?rev=2517221) ![](https://ps.w.org/list-category-posts/assets/icon-256x256.png?rev=2517221) # List category posts By [Fernando Briano](https://profiles.wordpress.org/fernandobt/) [Download](https://downloads.wordpress.org/plugin/list-category-posts.0.95.0.zip) * [Details](https://ary.wordpress.org/plugins/list-category-posts/#description) * [Reviews](https://ary.wordpress.org/plugins/list-category-posts/#reviews) * [Installation](https://ary.wordpress.org/plugins/list-category-posts/#installation) * [Development](https://ary.wordpress.org/plugins/list-category-posts/#developers) [Support](https://wordpress.org/support/plugin/list-category-posts/) ## Description List Category Posts allows you to list posts by category in a post or page using the `[catlist]` shortcode. When you’re editing a page or post, directly insert the shortcode in your text and the posts will be listed there. The _basic_ usage would be something like this: ``` [catlist id=1] [catlist name="news"] ``` The 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 also display the post author, date, excerpt, custom field values, even the content! A lot of parameters have been added to customize what to display and how to show it. Check [the full documentation](https://github.com/picandocodigo/List-Category-Posts/wiki) to learn about the different ways to use it. The `[catlist]` shortcode can be used as many times as needed with different arguments on each post/page. [catlist id=1 numberposts=10] There’s an options page with a few options, new options will be implemented on demand( as long as they make sense). **[Read the instructions](https://github.com/picandocodigo/List-Category-Posts/wiki)** to learn which parameters are available and how to use them. If you want to **List Categories** instead of posts you can use my other plugin ** [List categories](https://wordpress.org/plugins/list-categories/)**. You can find **Frequently Asked Questions** [here](https://github.com/picandocodigo/List-Category-Posts/blob/master/doc/FAQ.md#frequently-asked-questions). **Customization** The different elements to display can be styled with CSS. you can define an HTML tag to wrap the element with, and a CSS class for this tag. Check [the documentation](https://github.com/picandocodigo/List-Category-Posts/wiki) for usage. You can also check [this nice tutorial](http://sundari-webdesign.com/wordpress-the-quest-to-my-perfect-list-view-for-posts-events-and-articles/) which gives lots of tips and how-to’s to customize how to display the posts. Great to use WordPress as a CMS, and create pages with several categories posts. **GUI** Klemens Starybrat has created a GUI for List Category Posts. It helps you create a shortcode from a nice visual interface in WordPress’ text editor. Check it out: [GUI for List Category Posts](https://wordpress.org/plugins/gui-for-lcp/) **AJAX pagination** The ajax pagination feature is maintained in an add-on plugin by Klemens Starybrat. Check it out: [LCP Ajax Pagination](https://wordpress.org/plugins/lcp-ajax-pagination) **Widget** Since WordPress 4.9, [you can use shortcode in text widgets](https://make.wordpress.org/core/2017/10/24/widget-improvements-in-wordpress-4-9/). So you can just add a text widget in Appearence > Widgets and write the List Category Posts shortcode. The plugin also includes a widget as a simple interface for its functionality. Just add as many widgets as you want, and select all the available options from the Appearence > Widgets page. Not all the functionality in the shortcode has been implemented in the widget yet. You can use the shortcode for the most flexibility. Please, read the information on [the wiki](https://github.com/picandocodigo/List-Category-Posts/wiki) and [Changelog](https://wordpress.org/plugins/list-category-posts/#developers) to be aware of new functionality, and improvements to the plugin. **Videos** Some users have made videos on how to use the plugin (thank you, you are awesome!), check them out here: * [Manage WordPress Content with List Category Posts Plugin](http://www.youtube.com/watch?v=kBy_qoGKpdo) * [WordPress: How to List Category Posts on a Page](http://www.youtube.com/watch?v=Zfnzk4IWPNA) **Support the plugin** Klemens Starybrat has been writing lots of amazing code for this plugin, so if you’ve found it useful and want to pay it forward, consider sponsoring him on GitHub: https:// github.com/sponsors/klemens-st I have a [PayPal account](http://picandocodigo.net/programacion/wordpress/list-category-posts-wordpress-plugin-english/#support) where you can donate too. **Development** Development is being tracked on [Codeberg](https://codeberg.org/picandocodigo/list-category-posts) and [GitHub](https://github.com/picandocodigo/List-Category-Posts). Fork it, code, make a pull request, suggest improvements, etc. over there. I dream of the day all of the WordPress plugins will be hosted on Git 🙂 Since the documentation on how to use the plugin has passed wordpress.org’s character limit, the text was cut. You can find the complete documentation on [the wiki](https://github.com/picandocodigo/List-Category-Posts/wiki). It’s also more comfortable to read and maintain than a txt file. Please check it out, suggestions are welcome on Codeberg/GitHub issues! ### Instructions on how to use the plugin Below you can find common shortcode use cases. You can use the shortcode while editing posts, pages, custom post types, text widgets and in all “page builder” plugins that support shortcodes. Read the **[full documentation](https://github.com/picandocodigo/List-Category-Posts/wiki)** to discover many more features, including: * **advanced post selection options** (by date, search terms, custom fields, post types, custom taxonomies and more) * **output customizations** (show each post’s date, author, excerpt, thumbnail and more) * **custom templates** of your own design, based on a simple PHP example List 10 latest posts: ``` [catlist] ``` The default number of listed posts is 10, to modify it you need to specify `numberposts` parameter: ``` [catlist numberposts=15] ``` List posts from the “Dogs” category: ``` [catlist name=Dogs] ``` List posts from the category with id `2`: ``` [catlist id=2] ``` By default only the “post” post type is included. To list pages use: ``` [catlist post_type=page] ``` and for both posts and pages: ``` [catlist post_type="post,page"] ``` If we combine the above options we can get a shortcode that lists 15 items, including post and pages, from the “Dogs” category: ``` [catlist name=Dogs post_type="post,page" numberposts=15] ``` Most of the parameters you will find in the documentation can be used together. The plugin can detect current post’s category and use it for listing: ``` [catlist categorypage=yes] ``` Same goes for tags: ``` [catlist currenttags=yes] ``` To show each post’s excerpt use: ``` [catlist excerpt=yes] ``` If you want to show the date, author and comments count next to each post, use: ``` [catlist date=yes author=yes comments=yes] ``` You can specify html tags and classes for many elements. Let’s modify the previous shortcode and wrap dates and authors in tags and classes of our choice: ``` [catlist date=yes date_tag=span date_class="my-date" author=yes author_tag=p author_class="my-author" comments=yes] ``` [Read more about this feature](https://github.com/picandocodigo/List-Category-Posts/wiki/HTML-&-CSS-Customization) You can order posts by date: ``` [catlist orderby=date] ``` You can also use `title`, `author`, `ID`. More options are described in the documentation. The plugin also supports pagination. You need to specify `numberposts` to tell the plugin how many posts per page you want: ``` [catlist pagination=yes numberposts=5] ``` See the wiki: [Pagination](https://github.com/picandocodigo/List-Category-Posts/wiki/Pagination) for more information. Please read the **[full documentation](https://github.com/picandocodigo/List-Category-Posts/wiki)** for detailed documentation of all plugin features, use cases and shortcode parameters. ## Installation * Upload the `list-category-posts` directory to your wp-content/plugins/ directory. * Login to your WordPress Admin menu, go to Plugins, and activate it. * Start using the ‘[catlist]` shortcode in your posts and/or pages. * You can find the List Category Posts widget in the Appearence > Widgets section on your WordPress Dashboard. * If you want to customize the way the plugin displays the information, check [HTML & CSS Customization](https://github.com/picandocodigo/List-Category-Posts/wiki/HTML-&-CSS-Customization) or the [section on Templates](https://github.com/picandocodigo/List-Category-Posts/wiki/Template-System) on the wiki. ## FAQ You can find the Frequently Asked Questions [here](https://github.com/picandocodigo/List-Category-Posts/blob/master/doc/FAQ.md#frequently-asked-questions). ### INSTRUCTIONS ON HOW TO USE THE PLUGIN Check out [the Wiki](https://github.com/picandocodigo/List-Category-Posts/wiki/) Please read the instructions and the FAQ before opening a new topic in the support forums. ### Widget The widget is quite simple, and it doesn’t implement all of the plugin’s functionality. Since WordPress 4.9, you can use a shortcode in a widget. If you’re using a previous WordPress version, add this code to your theme’s functions.php file: ``` add_filter('widget_text', 'do_shortcode'); ``` Then just add a new text widget to your blog and use the shortcode there as the widget’s content. ### HTML & CSS Customization [HTML and CSS Customization](https://github.com/picandocodigo/List-Category-Posts/wiki/HTML-&-CSS-Customization) ### TEMPLATE SYSTEM How to customize the way the posts are shown: [Template System](https://github.com/picandocodigo/List-Category-Posts/wiki/Template-System). ### NEW FEATURE REQUESTS, BUG FIXES, ENHANCEMENTS You can post them on [GitHub Issues](https://github.com/picandocodigo/List-Category-Posts/issues). ### FURTHER QUESTIONS Please check the [FAQ](https://github.com/picandocodigo/List-Category-Posts/blob/master/doc/FAQ.md#frequently-asked-questions) before posting a question. You can post questions in the [Support forum](https://wordpress.org/support/plugin/list-category-posts) or [add a new issue on GitHub](https://github.com/picandocodigo/List-Category-Posts/issues). ## Reviews ![](https://secure.gravatar.com/avatar/2672006b7131b4cb66c0d7ba96ff43332c2facf35abf05bb681411372dd10fa5? s=60&d=retro&r=g) ### 󠀁[Fantastic](https://wordpress.org/support/topic/fantastic-3479/)󠁿 [Jlwp](https://profiles.wordpress.org/jlwp123/) يناير 10, 2026 1 reply This is an absolutely amazing plugin because it can be used in so many different ways from eg creating a Navigation page that lists pages categorized with “Navigation”, to creating “Related pages” etc. It even can be used with tags not only categories. And more. ![](https://secure.gravatar.com/avatar/9029b147f29039a7c4d24e690a877d3cf7b820f2a92f0faf9a07ea52435e1fdf? s=60&d=retro&r=g) ### 󠀁[wonderful plugin](https://wordpress.org/support/topic/wonderful-plugin-803/)󠁿 [gdavide](https://profiles.wordpress.org/gdavide/) شتنبر 2, 2024 I used to do this kind of things with manual and hacky changes to wordpress themes, this created a lot of problem to upgrade themes. With this plugin you can change the post lists in a lot of ways. It saves my day! ![](https://secure.gravatar.com/avatar/da552dddb63bc90f0754b737924baeea6439759d62a62ada97d51f2718e5eb2e? s=60&d=retro&r=g) ### 󠀁[Works great with the free Beaver Builder!](https://wordpress.org/support/topic/works-great-with-the-free-beaver-builder/)󠁿 [Brisch](https://profiles.wordpress.org/brisch/) فبراير 18, 2024 1 reply Works great if you want to show a post preview on a page with the free Version Beaver Builder! ![](https://secure.gravatar.com/avatar/ad2fbb909db1b64d7a1928490f1e862ace829ff5a8788e9e225538293d5aff29? s=60&d=retro&r=g) ### 󠀁[Enhancing Content Organization and Presentation: A Review of List Category Posts](https://wordpress.org/support/topic/enhancing-content-organization-and-presentation-a-review-of-list-category-posts/)󠁿 [Alex De Py](https://profiles.wordpress.org/alexnleo/) يناير 12, 2024 As a long-time WordPress user, I’ve encountered numerous plugins, each promising to enhance the functionality of my website. However, few have impressed me as much as the List Category Posts plugin. This versatile tool has become an indispensable part of my WordPress toolkit, streamlining how I organize and display content across my site. The plugin’s core strength lies in its simplicity and effectiveness. With straightforward shortcode implementation, I can easily display a list of posts from specific categories on any page or post. This functionality not only improves the navigability of my site but also enhances the overall user experience. The ability to fine-tune the display – including adjusting post counts, ordering, and even including elements like excerpts and author names – provides a level of customization that is both powerful and user-friendly. One feature I particularly appreciate is the plugin’s ability to detect the current post’s category and use it for listing, making dynamic content display a breeze. The flexibility to mix post types in a single list further adds to its utility, especially for sites with diverse content. The plugin’s developer has done an exceptional job in balancing functionality with usability. The extensive documentation and active support ensure that even less tech-savvy users can make the most of its features. Its compatibility with various themes and plugins makes it a reliable choice for a wide range of WordPress users. In summary, the List Category Posts plugin stands out for its effectiveness in enhancing content organization and presentation on WordPress sites. It’s a testament to thoughtful development focused on real-world utility and user experience. ![](https://secure.gravatar.com/avatar/f48fd83a431fc94c3d2556d45ac75a21040cce1960e84ec3b0ca8183a01eb1dd? s=60&d=retro&r=g) ### 󠀁[Allows me to use WP like the database it is](https://wordpress.org/support/topic/allows-me-to-use-wp-like-the-database-it-is/)󠁿 [WebSprite](https://profiles.wordpress.org/contentsprite/) شتنبر 6, 2023 I’ve been using this plug in for years – and I’ve been remiss not leaving a review. I run a single site with a core set of portfolio type items that have a general information page. Because of this plugin, I can type the description in a portfolio type post and have just the pieces I want replicated on the product page or in a blog post about the item. That’s what databases are supposed to do – avoid replication of the same data. I decide to update a description, I fix it in one place and anywhere I’ve used that description gets updated. It took trial and error and poring over the documentation, which is really good, to make it all work, but it was completely worth it. Thank you! ![](https://secure.gravatar.com/avatar/26cf99292b5e78c3a05ef1d934371459a04afe4d03edbdb529017751bbe610ec? s=60&d=retro&r=g) ### 󠀁[great plugin](https://wordpress.org/support/topic/great-plugin-37414/)󠁿 [d2pren](https://profiles.wordpress.org/d2pren/) غشت 17, 2023 Very usefull for me [ Read all 254 reviews ](https://wordpress.org/support/plugin/list-category-posts/reviews/) ## Contributors & Developers “List category posts” is open source software. The following people have contributed to this plugin. Contributors * [ Fernando Briano ](https://profiles.wordpress.org/fernandobt/) * [ zymeth25 ](https://profiles.wordpress.org/zymeth25/) “List category posts” has been translated into 17 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/list-category-posts/contributors) for their contributions. [Translate “List category posts” into your language.](https://translate.wordpress.org/projects/wp-plugins/list-category-posts) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/list-category-posts/), check out the [SVN repository](https://plugins.svn.wordpress.org/list-category-posts/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/list-category-posts/) by [RSS](https://plugins.trac.wordpress.org/log/list-category-posts/?limit=100&mode=stop_on_copy&format=rss). ## Changelog See [CHANGELOG.md](https://github.com/picandocodigo/List-Category-Posts/blob/master/CHANGELOG.md) for full Changelog. #### 0.95.0 * Bugfix: Removes double slash in pagination code. Fixes https://github.com/picandocodigo/ List-Category-Posts/issues/531. * Addresses potential security vulnerability CVE-2026-3005 * Bugfix: lcp_title_limit corrupts multibyte characters in fallback path. Fixes https://github.com/picandocodigo/List-Category-Posts/issues/549. Thanks @jmingau for the report and fix! #### 0.94.0 * Addresses CVE-2026-0553. * Addresses potential debug warning: `Undefined array key QUERY_STRING`. Report: https://wordpress.org/support/topic/php-8-4-issue-2/ * Escapes html for thumbnail class. #### 0.93.1 * Fixes a bug with `post_status` introduced in `sanitize_status`. Thanks Galen Charlton (@gmcharlt) for the catch and fix! #### 0.93.0 * Don’t skip password protected filter when showing content. * Sanitize post_status so some posts are only shown if user is Editor or Administrator. * Addresses reported vulnerability: CVE-2025-11377, Authenticated (Contributor+) Information Exposure. Severity Score: 4.3 (Medium). CVSS Vector: CVSS:3.1/AV: N/AC:L/PR:L/UI:N/S:U/C:L/I:N/A:N. Organization: Wordfence. Vulnerability Researcher( s): Athiwat Tiprasaharn (Jitlada) This is a low risk vulnerability that could potentially be executed by an authenticated attacker, with contributor-level access and above. But it should be fixed with this version. #### 0.92.0 * Avoids potential SQL injection in `starting_with` parameter – CVE-2025-10163. This solves SQL injection and results in `starting_with` working as per the Wiki, but the previous code also allowed things like `[catlist starting_with="Hello"]` which would return posts starting with “Hello” but not just with “H”. This new implementation would return both, because only the first character matters, which is ok because that’s what is documented. * Improves template file inclusion security. Template files when using the `template` parameter can only have letters, numbers, `_` and `-` in the name. They also can only be located in the current theme’s directory under a `list-category-posts` directory. #### 0.91.0 * Addresses CVE-2025-47636, avoids Local File Inclusion for template system. The code will remove any occurrences of the string ‘../’ in the template parameter. Templates files must be php files located in a directory named `list-category- posts` under `wp-content/themes/your-theme-folder`. https://www.cve.org/CVERecord? id=CVE-2025-47636 #### 0.90.3 * Hardens xss fix for script tag by checking case insensitive and using tag_escape. #### 0.90.2 * Updates fix for stored cross-site scripting from 0.90.0, now applied to all tags. From this version onwards, script is not available to use as a tag when setting an element’s tag in the shortcode. #### 0.90.1 * Fix PHP 8.2 deprecation notices * Remove empty anchor tags from widget morelink #### 0.90.0 * Fixes a Stored Cross-Site Scripting issue using `excerpt_tag='script'`. ## Meta * Version **0.95.0** * Last updated **شهر واحد ago** * Active installations **80,000+** * WordPress version ** 3.3 or higher ** * Tested up to **6.9.4** * PHP version ** 5.6 or higher ** * Languages * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/list-category-posts/), [Dutch](https://nl.wordpress.org/plugins/list-category-posts/), [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/list-category-posts/), [English (US)](https://wordpress.org/plugins/list-category-posts/), [French (France)](https://fr.wordpress.org/plugins/list-category-posts/), [Galician](https://gl.wordpress.org/plugins/list-category-posts/), [German](https://de.wordpress.org/plugins/list-category-posts/), [Indonesian](https://id.wordpress.org/plugins/list-category-posts/), [Italian](https://it.wordpress.org/plugins/list-category-posts/), [Japanese](https://ja.wordpress.org/plugins/list-category-posts/), [Korean](https://ko.wordpress.org/plugins/list-category-posts/), [Portuguese (Portugal)](https://pt.wordpress.org/plugins/list-category-posts/), [Russian](https://ru.wordpress.org/plugins/list-category-posts/), [Spanish (Chile)](https://cl.wordpress.org/plugins/list-category-posts/), [Spanish (Colombia)](https://es-co.wordpress.org/plugins/list-category-posts/), [Spanish (Spain)](https://es.wordpress.org/plugins/list-category-posts/), [Spanish (Venezuela)](https://ve.wordpress.org/plugins/list-category-posts/), and [Swedish](https://sv.wordpress.org/plugins/list-category-posts/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/list-category-posts) * Tags * [categories](https://ary.wordpress.org/plugins/tags/categories/)[cms](https://ary.wordpress.org/plugins/tags/cms/) [list](https://ary.wordpress.org/plugins/tags/list/)[posts](https://ary.wordpress.org/plugins/tags/posts/) * [Advanced View](https://ary.wordpress.org/plugins/list-category-posts/advanced/) ## Ratings 4.7 out of 5 stars. * [ 218 5-star reviews ](https://wordpress.org/support/plugin/list-category-posts/reviews/?filter=5) * [ 19 4-star reviews ](https://wordpress.org/support/plugin/list-category-posts/reviews/?filter=4) * [ 6 3-star reviews ](https://wordpress.org/support/plugin/list-category-posts/reviews/?filter=3) * [ 3 2-star reviews ](https://wordpress.org/support/plugin/list-category-posts/reviews/?filter=2) * [ 8 1-star reviews ](https://wordpress.org/support/plugin/list-category-posts/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/list-category-posts/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/list-category-posts/reviews/) ## Contributors * [ Fernando Briano ](https://profiles.wordpress.org/fernandobt/) * [ zymeth25 ](https://profiles.wordpress.org/zymeth25/) ## Support Issues resolved in last two months: 0 out of 2 [View support forum](https://wordpress.org/support/plugin/list-category-posts/) ## Donate 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)