Title: Display Posts – Easy lists, grids, navigation, and more Author: Bill Erickson Published: July 13, 2011 Last modified: October 14, 2024 --- Search plugins ![](https://ps.w.org/display-posts-shortcode/assets/banner-772x250.jpg?rev=2940963) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/display-posts-shortcode/assets/icon-256x256.jpg?rev=2940963) # Display Posts – Easy lists, grids, navigation, and more By [Bill Erickson](https://profiles.wordpress.org/billerickson/) [Download](https://downloads.wordpress.org/plugin/display-posts-shortcode.3.0.3.zip) * [Details](https://srd.wordpress.org/plugins/display-posts-shortcode/#description) * [Reviews](https://srd.wordpress.org/plugins/display-posts-shortcode/#reviews) * [Installation](https://srd.wordpress.org/plugins/display-posts-shortcode/#installation) * [Development](https://srd.wordpress.org/plugins/display-posts-shortcode/#developers) [Support](https://wordpress.org/support/plugin/display-posts-shortcode/) ## Description Display Posts allows you easily list content from all across your website. Start by adding this shortcode in the content editor to display a list of your most recent posts: ``` [display-posts] ``` **Filter by Category** To only show posts within a certain category, use the category parameter: ``` [display-posts category="news"] ``` **Display as Post Grid** You can create a great looking, column-based grid of posts with a bit of styling. [Here’s how!](https://displayposts.com/2019/01/04/post-grid-styling/) **List Popular Posts** You can highlight your popular content in multiple ways. If you want to feature the posts with the most comments, use: ``` [display-posts orderby="comment_count"] ``` You can also list [most popular posts by social shares](https://displayposts.com/2019/01/04/most-popular-posts-by-social-shares/). **Include thumbnails, excerpts, and more** The [display parameters](https://displayposts.com/docs/parameters/#display-parameters) let you control what information is displayed for each post. To include an image and summary, use: ``` [display-posts include_excerpt="true" image_size="thumbnail"] ``` You can use any image size added by WordPress (thumbnail, medium, medium_large, large) OR any custom image size added by your theme or other plugins. **Sort the list however you like** By default the listing will list the newest content first, but you can order by title, menu order, relevance, content type, metadata, and more. **List upcoming events** You can easily list upcoming events from any event calendar. Each plugin will require slightly different code. Here are [tutorials for popular event calendar plugins](https://displayposts.com/tag/events/). If your plugin is not listed here, submit a support request and I’ll add it! **Tutorials** [Our tutorials](https://displayposts.com/tutorials/) cover common customization requests, and are updated often. **Full Documentation** * [Query parameters](https://displayposts.com/docs/parameters/#query-parameters) for customizing which posts are listed (filter by category, tag, date…) * [Display parameters](https://displayposts.com/docs/parameters/#display-parameters) determine how the posts appear (title, excerpt, image…) * [Template parts](https://displayposts.com/2019/01/04/use-template-parts-to-match-your-themes-styling/) for Display Posts to perfectly match your theme’s post listings * [Output filter](https://displayposts.com/docs/the-output-filter/) for complete control over how the listing looks on your site * [Filters](https://displayposts.com/docs/parameters/#display-parameters) for even more powerful customizations for developers **Extensions** * [Display Posts – Pagination](https://github.com/billerickson/Display-Posts-Pagination)– Allow results of Display Posts to be paginated * [Display Posts – Date View](https://wordpress.org/plugins/display-posts-date-view/)– Lets you break your content down by month or year. * [Display Posts – Alpha View](https://github.com/billerickson/Display-Posts-Alpha-View)– Display an alphabetical listing of your content, broken down by letter * [Display Posts – Transient Cache](https://github.com/billerickson/Display-Posts-Transient-Cache)– Cache the output using transients * [Co-Authors Plus Addon](https://github.com/billerickson/dps-coauthor-addon) – multiple authors on posts * [Columns Extension](https://github.com/billerickson/dps-columns-extension) – display posts in columns * [DPS Exclude Sticky](https://github.com/billerickson/DPS-Exclude-Sticky) – exclude sticky posts unless specifically requested * [DPS Pinch Zoomer](https://github.com/shazahm1/Display-Posts-Shortcode-Pinch-Zoomer)– adds support pinch zooming post images on mobile devices and mouse wheel zooming on desktops * [Display Posts Shortcode Remote](https://github.com/shazahm1/Display-Posts-Shortcode-Remote)– display posts from a remote WordPress site utilizing the WP REST API. ## Installation 1. Upload `display-posts-shortcode` to the `/wp-content/plugins/` directory. 2. Activate the plugin through the _Plugins_ menu in WordPress. 3. Add the `[display-posts]` shortcode to a post or page. ## Reviews ![](https://secure.gravatar.com/avatar/e9bfc6bfa914b1b6d2e0dc60f10b07e813ca849cd9ecd2918c9024ab56433e74? s=60&d=retro&r=g) ### 󠀁[Excellent](https://wordpress.org/support/topic/excellent-14038/)󠁿 [Pieter Bos](https://profiles.wordpress.org/senlin/) August 27, 2025 Any plugin coming from Bill Erickson can be trusted as an excellent coded tool! And this Display Posts plugin doesn’t disappoint. If you’re looking for an easy way to add posts anywhere you want without hacking theme files, the Display Posts plugin is the one you want to install! Lightweight and highly customisable. Thanks Bill! ![](https://secure.gravatar.com/avatar/4fe4accb009cf59c921d260ea38b82e55a1cbc2b50241620957533255fd85f2c? s=60&d=retro&r=g) ### 󠀁[Amazing](https://wordpress.org/support/topic/amazing-4142/)󠁿 [Aliandro](https://profiles.wordpress.org/aliandro/) May 31, 2025 It’s amazing that at this time, we still have a fully functional free plugin with no paid version! ![](https://secure.gravatar.com/avatar/8a06e2a49c8bb9f8f3740701d22314454831c42dbc92b61e833691ce4dd291aa? s=60&d=retro&r=g) ### 󠀁[Great plugin](https://wordpress.org/support/topic/great-plugin-38218/)󠁿 [ste_yeu](https://profiles.wordpress.org/ste_yeu/) December 31, 2023 Very useful and easy to use ![](https://secure.gravatar.com/avatar/f5c6166d8b0683d9e0bd7b7f6ce0b8f01a5403ca8378264a6f7180f7569baa91? s=60&d=retro&r=g) ### 󠀁[Straight forward for desired simple layout](https://wordpress.org/support/topic/straight-forward-for-desired-simple-layout/)󠁿 [NightL](https://profiles.wordpress.org/nightl/) December 20, 2023 Themes often override page layout/template options when designating them to built in posts archive page – this plugin allowed a simple display of posts just as I required using a shortcode, allowing me to have full control over the environment it was placed in.Will require CSS knowledge to adjust appearance. If that is not for you then purchase a plugin that offers those adjustments via GUI. ![](https://secure.gravatar.com/avatar/432aa3b16e0fe938fa50ee648b01d1512874e84d3c4bb50783c2500a7893836b? s=60&d=retro&r=g) ### 󠀁[Really useful tool for showing posts and custom post types by tag, category, etc](https://wordpress.org/support/topic/really-useful-tool-for-showing-posts-and-custom-post-types-by-tag-category-etc/)󠁿 [primitivenet](https://profiles.wordpress.org/primitivenet/) November 7, 2023 Really useful tool for showing posts and custom post types by tag, category, etc ![](https://secure.gravatar.com/avatar/c7b3d099891944e218715ce49852af6d53876928d4b79f977ca83d17e25b00f8? s=60&d=retro&r=g) ### 󠀁[Great plugin with lots of CX options](https://wordpress.org/support/topic/great-plugin-with-lots-of-cx-options/)󠁿 [nmottet](https://profiles.wordpress.org/nmottet/) September 11, 2023 This plug is very easy to use and the best solution we have found to display lists of posts. We did do a bit of CSS/customization work to display the posts just the way we wanted (Small image, title only, etc), but there are out-of-the-box customization options that are very good. We have added their shortcodes on hundreds of pages to automatically display related posts that have the same tag (at the end of each post). You will need to spend at least 10-15 minutes to review their documentation on “Display settings” or “Filter settings” to understand how the shortcodes work. Overall: A+ [ Read all 164 reviews ](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/) ## Contributors & Developers “Display Posts – Easy lists, grids, navigation, and more” is open source software. The following people have contributed to this plugin. Contributors * [ Bill Erickson ](https://profiles.wordpress.org/billerickson/) [Translate “Display Posts – Easy lists, grids, navigation, and more” into your language.](https://translate.wordpress.org/projects/wp-plugins/display-posts-shortcode) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/display-posts-shortcode/), check out the [SVN repository](https://plugins.svn.wordpress.org/display-posts-shortcode/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/display-posts-shortcode/) by [RSS](https://plugins.trac.wordpress.org/log/display-posts-shortcode/?limit=100&mode=stop_on_copy&format=rss). ## Changelog **Version 3.0.3** * Bumped the “Tested To” number to WP 6.6 * Updated text of the plugin notice **Version 3.0.2** * Added `pre_display_posts_shortcode_output` filter before shortcode runs, used for transient caching, see [#210](https://github.com/billerickson/display-posts-shortcode/issues/214)* Updated plugin to pass coding standards, see [#214](https://github.com/billerickson/display-posts-shortcode/issues/214)* Removed survey admin notice, see [#213](https://github.com/billerickson/display-posts-shortcode/issues/213)* Don’t display empty term list, see [#208](https://github.com/billerickson/display-posts-shortcode/issues/208) **Version 3.0.1** * Prevent empty empty parameters from being added to the query, see [#207](https://github.com/billerickson/display-posts-shortcode/issues/207) **Version 3.0.0** * Added author_id parameter, see [#195](https://github.com/billerickson/display-posts-shortcode/issues/195)* Added has_password parameter * Added s parameter for performing a site search, see [#184](https://github.com/billerickson/display-posts-shortcode/issues/184) * Added date_format=”relative” format option (ex: 2 days ago), see [#194](https://github.com/billerickson/display-posts-shortcode/issues/194)* Added post_parent__in and post_parent__not_in parameters, see [#193](https://github.com/billerickson/display-posts-shortcode/issues/193)* Added excerpt_dash=”false” option to disable dash in excerpt, see [#204](https://github.com/billerickson/display-posts-shortcode/issues/204)* Added additional parameters to the `display_posts_shortcode_output` filter * Added additional parameters to the `display_posts_shortcode_category_display` filter, see [#185](https://github.com/billerickson/display-posts-shortcode/issues/185) * $dps_listing loop now accessible globally, see [#198](https://github.com/billerickson/display-posts-shortcode/issues/198)* $dps_listing loop now accessible in open/close filters * Added .excerpt-more class to excerpt more text, see [#205](https://github.com/billerickson/display-posts-shortcode/issues/205)* Now excerpt_more text is always appended to end of excerpt, see [#197](https://github.com/billerickson/display-posts-shortcode/issues/197)* In parameters that support multiple terms, they can now be separated with a comma or comma-space, see [#183](https://github.com/billerickson/display-posts-shortcode/issues/183) **Version 2.9.0** * New parameter `exclude` for excluding specific post IDs, see [#154](https://github.com/billerickson/display-posts-shortcode/issues/154) * New parameter `category_id` for specifying category by ID (note: only accepts a single ID), see [#156](https://github.com/billerickson/display-posts-shortcode/issues/156)* New parameter `include_date_modified` for displaying the date the post was last updated, see [#150](https://github.com/billerickson/display-posts-shortcode/issues/150)* Shortcode title now appears above the wrapper (ul/ol/div), fixing invalid markup, see [#165](https://github.com/billerickson/display-posts-shortcode/issues/165) * Limit visibility to readable posts **Version 2.8.0** * Added include_link=”false” to remove link from post title and image, see [#137](https://github.com/billerickson/display-posts-shortcode/pull/137)* Fixed category display when using multiple post types, see [#143](https://github.com/billerickson/display-posts-shortcode/issues/143)* Fixed issue combining multiple taxonomies, see [#131](https://github.com/billerickson/display-posts-shortcode/issues/131) **Version 2.7.0** * Added support for [Co-Authors Plus Addon](https://github.com/billerickson/dps-coauthor-addon).* Added parameter to exclude children terms in tax queries, [more information](https://github.com/billerickson/display-posts-shortcode/issues/120)* Added a filter to display the full version of manual excerpt, regardless of excerpt_length. [more information](https://github.com/billerickson/display-posts-shortcode/issues/123)* Removed shortcodes from custom excerpts, [more information](https://github.com/billerickson/display-posts-shortcode/issues/113)* Fixed private post visibility, [more information](https://github.com/billerickson/display-posts-shortcode/issues/115) **Version 2.6.2** * More improvements to excerpts, see #110 * Added content_class parameter * Fix date query bug, see #108 * Fixed undefined variable notice if include_title =”false” **Version 2.6.1** * Fix issue with manually specified excerpts **Version 2.6** * Add support for author=”current” * Add support for multiple wrapper classes * Add support for excerpt_length parameter * Add support for excerpt_more parameter **Version 2.5.1** * Fix an issue with manually specified excerpts **Version 2.5** * Add support for date queries * Exclude child pages with post_parent=”0″ * Query by current taxonomy terms. Ex: [display-posts taxonomy=”category” tax_term =”current”] * Display the post’s categories with [display-posts category_display=”true”] * Many more fixes. See GitHub for a full list of changes. **Version 2.4** * Add ‘include_author’ parameter * Add ‘exclude_current’ parameter for excluding the current post from the results * If you display the full content of results, additional uses of the shortcode within those posts are now turned off * Other minor improvements **Version 2.3** * Include the shortcode attributes on wrapper filter * Add ‘no_posts_message’ parameter to specify content displayed if no posts found * Add filters to the title and permalink * Limit private posts to logged in users * Add support for excluding sticky posts * Add support for ordering by meta_key **Version 2.2** * Use original attributes for filters * Add support for multiple taxonomy queries * Add filter for post classes * Add support for post content in the post loop **Version 2.1** * Add support for post status * Add support for post author * Add support for post offset **Version 2.0** * Explicitly declare arguments, props danielbachhuber * Sanitize each shortcode attribute for security, props danielbachhuber **Version 1.9** * Add ‘date_format’ parameter, so you can customize how dates are displayed * Added a class of .excerpt-dash so CSS can be used to remove the dash * Cleaned up the codebase according to WordPress coding standards **Version 1.8** * Added `display_posts_shortcode_no_results` filter for displaying content if there’s no posts matching current query. * Add support for multiple post types. [display-posts post_type=”page, post”] **Version 1.7** * Added `id` argument to specify specific post IDs * Added `display_posts_shortcode_args` filter in case the arguments you want aren’t already included in the shortcode. See example: http://www.billerickson.net/code/ display-posts-shortcode-exclude-posts/ **Version 1.6** * Added `post_parent` where you can specify a parent by ID, or you can say `post_parent =current` and it will use the current page’s ID. * Added `wrapper` where you can decide if the posts are an unordered list, ordered list, or div’s * Added support for multiple taxonomy terms (comma separated) and taxonomy operator( IN, NOT IN, or AND). **Version 1.5** * For the sake of clarity I’m changing version numbers. No feature changes **Version 0.1.5** * Added a filter (display_posts_shortcode_output) so you can modify the output of individual posts however you like. **Version 0.1.4** * Added post_type, taxonomy, tax_term, and include_excerpt * Added classes to each part of the listing (image, title, date, excerpt) to make it easier to change the look using CSS **Version 0.1.3** * Updated Readme **Version 0.1.2** * Added image_size option **Version 0.1.1** * Fix spacing issue in plugin **Version 0.1** * This is version 0.1. Everything’s new! ## Meta * Version **3.0.3** * Last updated **1 year ago** * Active installations **80,000+** * WordPress version ** 3.0 or higher ** * Tested up to **6.6.5** * Language * [English (US)](https://wordpress.org/plugins/display-posts-shortcode/) * Tags * [page](https://srd.wordpress.org/plugins/tags/page/)[pages](https://srd.wordpress.org/plugins/tags/pages/) [posts](https://srd.wordpress.org/plugins/tags/posts/)[query](https://srd.wordpress.org/plugins/tags/query/) [shortcode](https://srd.wordpress.org/plugins/tags/shortcode/) * [Advanced View](https://srd.wordpress.org/plugins/display-posts-shortcode/advanced/) ## Ratings 4.8 out of 5 stars. * [ 149 5-star reviews ](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/?filter=5) * [ 9 4-star reviews ](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/?filter=4) * [ 3 3-star reviews ](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/?filter=3) * [ 2 2-star reviews ](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/?filter=2) * [ 1 1-star review ](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/?filter=1) [Add my review](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/display-posts-shortcode/reviews/) ## Contributors * [ Bill Erickson ](https://profiles.wordpress.org/billerickson/) ## Support Issues resolved in last two months: 0 out of 1 [View support forum](https://wordpress.org/support/plugin/display-posts-shortcode/)