Posts in Sidebar


Posts in Sidebar is a plugin for WordPress that lets you show a list of your posts using the criteria you want. This plugin gives you almost all the power of WordPress to retrieve the posts you want and show them in your sidebars.

The plugin has also a shortcode, that you can use in your posts/pages to list your posts.

Once installed, Posts in Sidebar creates a new widget for your sidebar. Add it to your sidebar, select the options to retrieve the posts you want, and save the widget: you’re done!

Here are some of the functions you’ll have:

  • get posts by authors, categories, tags, post format, or any custom taxonomy;
  • get posts by exact IDs;
  • get posts by meta key/value;
  • get posts by modification date;
  • get posts children of other posts;
  • get posts by search;
  • get posts by recent comments;
  • get posts by complex taxonomies queries;
  • get posts by complex date queries;
  • get posts by complex custom fields queries;
  • get posts from the category of the current post;
  • exclude posts by authors, taxonomies, and so on;
  • control which elements of the posts are displayed (like post thumbnail, taxonomies, meta values, and so on);
  • stylize the output of the widget using custom CSS styles;
  • cache the output of the widget to save queries to the database;
  • … and much more.

The powerful WordPress class WP_Query is at your fingertips with this plugin. To understand what this plugin can do, take a look at this Codex page: almost all these functions are already included in Posts in Sidebar.

This plugin is free software and it’s developed with many efforts: a donation is very appreciated.


Documentation, Help & Bugs

The plugin’s documentation is hosted on GitHub. Please refer to it before asking for support.

If you need help, please use WordPress forum. Do not send private email unless it is really necessary.

If you have found a bug, please report it on GitHub.

This plugin is developed using GitHub. If you wrote an enhancement and would share it with the world, please send me a Pull request.


I would like to say Thank You to all the people who helped me in making this plugin better.

Translations of the plugin

This plugin has been translated into these languages:

  • Persian, thanks to AlirezaJamali
  • French, thanks to Thérèse Lachance and cilya
  • Hebrew, thanks to Ahrale.
  • Serbo-Croatian, thanks to Borisa Djuraskovic.


  • The widget panel (all sections are closed).
  • The widget panel (all sections are open).
  • A simple output of the widget: title, excerpt and link to the entire archive.
  • Displaying the featured image, floating left.
  • The same image as before, but in larger size.
  • The introductory text for the widget.
  • Displaying the full set of items (categories, date, author, tags, and so on).


Installing Posts in Sidebar

This section describes how to install the plugin and get it working.

  1. Upload the posts-in-sidebar directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress
  3. Go to the widgets manager and add the newly available widget into the sidebar
  4. Adjust the options to fit your needs
  5. Save and test your results.


Posts in Sidebar cleans up after itself. All plugin settings will be removed from your database when the plugin is uninstalled via the Plugins screen.


Please, see FAQ page on GitHub.


Joy to work with, but with some drawbacks

This is the pluging for custom lists in sidebar and footer!
Many settings, flexible views.
Highly recommended!

I wish I had opportunity to use it as a [shortcode] to place it anywhere around the page.

ALSO! It is possible to limit the length of post’s title or text to ### words (NOT SYMBOLS), which is weird. In most languages some words are very lenthy, some are real short. That results in funny looking lists sometimes and the plugin doesn’t help much. SO that’s the way to make the pluging a bit better.

Other plugins didn’t work!

My theme has small sidebar thumbnails. I can’t change the size of the thumbnails. I tried other sidebar plugins but none of them worked as I wanted.
With only this one I could add bigger thumbnails to the sidebar. “Posts in Sidebar” is perfect. Thanks!

An awesome plugin! Exactly what I needed, plus excellent support!

I was looking for a plugin that allowed me to control the post links that appeared in the sidebar as I wanted to show different posts at different times of the year. I also wanted to have thumbnails too.

This plugin did exactly what I needed and more. There are so many options. I also used it in my footer too. I ended up removing the other sidebar plugin I was using for this one.

I ran into a few snags but they were minimal and quickly fixed with help from the awesome support available. A recent update also added a feature I had asked about.

If you’re looking for a sidebar plugin this one is a definite must try!

Read all 67 reviews

Contributors & Developers

“Posts in Sidebar” is open source software. The following people have contributed to this plugin.


“Posts in Sidebar” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Posts in Sidebar” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Fixed displaying UTF-8 charset when shortening titles and excerpts.


  • Added options for title and WordPress-generated excerpt length unit.
  • Added filter for HTML arrows in title and excerpt.
  • Added CSS ID selector to ul.


  • Added option to shorten post titles.


  • Added option to get posts from the current tag, when on a single post.
  • Added option to assign post classes via get_post_class().
  • Fixed empty p tag when no excerpt or no image.
  • Fixed post modification date/time.
  • Minor fixes.


  • Added option to display the post time and modification time.
  • Aligned shortcode options to main options.
  • Comments are not linked to comments section in the post by default.


  • Added option to get posts by recent comments.
  • Added option to display all the custom fields of the post.


  • Added section for retrieving posts from multiple custom fields.
  • Added option for retrieving posts with/without password.
  • Added option for retrieving posts with a certain password.
  • Now panels do not collapse after saving the widget.


  • Added option to get multiple post types.
  • Removed option for displaying query number (it’s displayed by default now).


  • Fixed link on titles and title arrows.
  • Fixed a bug where, regardless of the state of “Display the featured image of the post” checkbox, the featured image was always visible if the “Display this section before the title of the post” checkbox were active.


  • Added option to get posts from a certain amount of time ago.
  • Removed empty items from the array for the query.
  • Removed some default settings in custom taxonomy query.


  • Updated the description in “When on single posts, get posts from the current category”.


  • Added option to maintain active other parameters when on single post (props by techsmurfy).
  • Added option to sort categories of the main post before getting the posts for the sidebar. When the user wants to get posts from the current category, now the user can choose to fetch posts from the main category of the main post (i.e. the category with the lowest ID) or from the category with the lowest key ID in the array of categories (props by techsmurfy).
  • Added options to move certain parts before/after the title.
  • Removed empty lines in the HTML source.
  • Added Indonesian translation, thanks to Jordan Silaen.


  • Added option to display debugging information to admins only.
  • Now the custom field value for getting posts via custom field key can be the taxonomy ID (props by morfe1).
  • Removed Italian l10n from languages/ directory, because the Italian language pack in GlotPress is completed.
  • Hardening security on i18n.


  • Rewritten function for displaying the Read more.
  • Completely removed the HTML title attribute on links.
  • Aligned widget and shortcode options.
  • Minor corrections.


  • Exclude current post even if the user has specified a list of IDs.
  • Removed title attribute on links.


  • FIX: The “Rich Content” option for excerpt correctly executes shortcodes now.
  • If the length of a WordPress-generated excerpt is smaller than or equal to the maximum length defined by the user for the excerpt, the “Read more…” text is automatically hidden.
  • Reduced widget width to 600px in the admin area.


  • NEW: Added support to get posts, when on single post, from user-defined category/tag using custom field (props by Mike S).
  • NEW: Added support for changing number of posts when on single post.
  • FIX: fixed displaying comments string when using languages different from English.


  • NEW: now the user can remove the link of the featured image.


  • NEW: Added support to get posts by the author of the current post (props by Derek).
  • FIX: fixed getting posts by category slug.
  • Updated the shortcodes options.


  • Updated the shortcodes options.


  • FIX: fixed wrong characters displaying in custom field values (props by bubdev).
  • Minor improvements.


  • NEW: Added option to truncate the custom field content (props by bubdev).


  • NEW: Added support to get posts from the category of the current post (props by wendygordon).
  • Minor improvements.


  • NEW: Added option to display the modification date (props by ecdltf).


  • Fixed shortcodes execution in “Full content” type of text (thanks to fabianfabian for reporting).
  • Added check if the post is private.
  • Added check for current post in pages.
  • Added link to review page in the plugins list page.


  • NEW: Added the shortcode.
  • NEW: Added Gravatar support for authors.
  • NEW: Added “Any” to posts status.
  • NEW: Added an option to change the tooltip in the title link.
  • Reorganized the widget sections.
  • Changed some files names.
  • Changed translation domain into posts-in-sidebar.


  • Fixed custom container DIV (thanks to felipebadr).
  • Minor improvements.


  • FIX: Fixed sticky posts.
  • The complete list of widget options is now fully displayed.
  • Other minor improvements.


  • FIX: Fixed link on widget title.


  • FIX: Fixed printing local style.


  • NEW: Support for taxonomy complex queries (requires WordPress 4.1).
  • NEW: Support for date queries.
  • NEW: Support for for getting and excluding posts by multiple authors.
  • NEW: Support for queries based on search.
  • NEW: Support for getting and excluding posts that are children of other posts.
  • NEW: Support for custom taxonomies.
  • NEW: Added support for custom link in featured image (props by troy-f).
  • NEW: Changed appearance for widget sections that are collapsible now.
  • WordPress 4.1 is required (for nested taxonomy handling).
  • Added URL of the site and WordPress version in the debug section.
  • Switched to PHP5 __contruct() in creating the widget.
  • Improved security.
  • Fixed PHP notices when upgrading from previous versions.
  • Updated the Hebrew translation (thanks to Ahrale).


  • Added check for “NULL” (as string) value in certain variables.
  • FIX: Now the plugin correctly displays attachment post type.
  • FIX: Custom featured images are now displayed when the user choose no text to display.


  • NEW: Now it’s possible to display the name of the taxonomy in the archive link.
  • FIX: resolved multiple PHP notices.


  • Compatibility with Relevantssi plugin (props by KTS915).
  • Updated the Hebrew translation (thanks to Ahrale).


  • NEW: Added options to use a custom image instead of the standard featured image (props by joaogsr).
  • NEW: Added class “sticky” if a post is sticky (props by acrok).
  • CHANGE: Added a checkbox to completely hide the widget if no posts are found (instead of removing the “no posts text” in order to do this).
  • Added placeholders in HTML fields.


  • FIX: resolved “No posts” issue when upgrading from 1.22 version.
  • Updated Hebrew (thanks to Ahrale) and Italian translations.


  • NEW: the widget can be hidden now if no posts are found (props by der_velli).
  • NEW: Added the option to display the full size of the featured image (props by Ilaria).
  • Moved plugin’s functions files into subfolder.
  • Moved plugin’s functions into separate file.
  • Added debugging tools.
  • Fixed one undefined index notice.
  • Updated the Hebrew translation (thanks to Ahrale).
  • Code improvements.


  • NEW: Added an option to display only the “Read more…” link.
  • Updated the Hebrew translation (thanks to Ahrale).
  • Added Serbo-Croatian language (thanks to Borisa Djuraskovic).


  • NEW: Added an option to exclude the current post in single post page or the current page in single page.
  • Added an alert in the widget admin if the current theme doesn’t support the Post Thumbnail feature.


  • FIX: Now the dropdown menu for post type selection correctly displays all the public post types (thanks to pathuri).


  • NEW: Selection of categories and tags is in form of comma separated values. This will prevent server load in case there are too many terms. Also, now the user can get posts from multiple categories.


  • NEW: The section with author, date, and comments can now be displayed before the post’s excerpt.
  • Various small improvements.


  • NEW: Added option to exclude posts with certain IDs.
  • NEW: Added option to display image before post title.
  • NEW: Completed options for Order by parameter.
  • Now the plugin requires at least WordPress 3.5.
  • Code optimization.
  • The class for the custom container class is now sanitized.
  • The custom container receives now only a single CSS class.
  • Completed the PhpDocumentor tags.


  • NEW: The cache can be flushed now.
  • Updated Hebrew translation.


  • NEW: Added a field to define a class for a container.
  • NEW: Now the user can define a cache when retrieving posts from database.


  • FIX: The HTML for ul is now fixed.


  • NEW: The posts can be retrieved using the ID (props by Matt).
  • NEW: The list of posts can now be displayed in a numbered list (props by Sean).
  • NEW: The excerpt can be displayed up to the “more” tag (props by EvertVd).
  • FIX: There are no more empty spaces after “Category” or “Tags” text.
  • The widget panel has been slightly enlarged.
  • Deleted unused options in widgets dropdown menus.
  • Minor refinements.


  • FIX: fetching posts from tags now works correctly.
  • Updated Hebrew translation, thanks to Ahrale.


  • NEW: Added option for adding user defined styles (props by Ahrale).
  • NEW: Added option for setting the space around the image (props by Ahrale).
  • NEW: Added check for rtl languages (the arrow can now be from right to left, props by Ahrale).
  • NEW: Added option for ordering by “Menu order” and “Comment count” (props by hypn0ticnet).
  • Updated Hebrew translation (thanks to Ahrale).
  • Minor bug fixings.
  • Minor enhancements.


  • NEW: added option for rich content.
  • NEW: added option for displaying the custom fields value/key of the post.
  • NEW: added option for removing bullets and extra left space for the list elements.
  • Code improvements.


  • FIX: image align has been fixed (thanks to Clarry).


  • FIX: If the post is password protected, now the post password form is displayed before showing the post.
  • NEW: Now the user-defined excerpt can display a paragraph break, if any.
  • NEW: Added Hebrew translation, thanks to Ahrale.
  • Other minor changes.


  • NEW: The space after each line can be defined via widget interface.
  • NEW: The featured image can be aligned with text.
  • NEW: Added apply_filters where needed.
  • FIX: HTML structure for the archive link is now W3C valid, thanks to cilya for reporting it.
  • Updated French translation, thanks to cilya.
  • Minor bug fixings.


  • New: added post format as option to get posts.
  • New: added option for link to custom post type archive.
  • New: added option for link to post format archive.
  • Other minor changes.


  • New: The widget can display the author of the post.
  • New: Now the user can choose which type of posts to display: posts, pages, custom post types, etc.
  • New: The widget can display the full content (as in single posts).
  • New: Now the user can add a custom “Read more” text.
  • Added French translation by Thérèse Lachance.
  • Code improvements and sanitization.


  • New: if in single post, the user can now stylize the current post in the sidebar (feature request from lleroy).


  • New: Now the title of the widget can be linked to a user-defined URL (feature request from Mike).


  • New: Now the user can add an introductory text to the widget (feature request from Mike).


  • New: The date can be linkified or not.
  • New: The widget panel now shows empty categories and tags.
  • New: The ‘No posts yet.’ text can be customized.
  • Bug fix: The markup no longer shows empty containers.
  • Some minor enhancements.


  • Changed the minimum required WordPress version to 3.3.
  • Added Persian language, thanks to AlirezaJamali.


  • Enhancement: Now the user can display the entire content for each post. Feature request from sjmsing
  • Moved screenshots to /assets/ directory.


  • Enhancement: Now it is possible to show the categories of the post
  • Enhancement: Now it is possible to exclude posts coming from some categories and/or tags
  • Moved the widget section into a separate file.


  • Updated Credits section.


  • Small typo in readme.txt.


  • First release of the plugin.