Use Shortcode to add “Category Posts Widget” to the content

YES!, the Category Posts Widget is escaping the WordPress sidebar and making its way into any place you can use Shortcode. I think the utility of such a feature is obvious, but to explicitly name at least one obvious use case it will be to give the list of the latest new/PR release. A more respectable place on your home page.

It is also creates a better experience for people that use page builders and tried to integrate the widget into the page builder content.

We are  doing something innovative here. We are assuming that we will have to iterate several times before making it perfect. For that we will need your feedback 😉

How can you use it

The usage of the “widget in a shortcode” has several easy to follow phases:

  1. Just place the shortcode [catposts] at whatever place in the post you want the list of posts to be displayed.
  2. Go to preview of the post (it doesn’t have to be preview, any way in which you get the admin bar to show up when you are looking at the post will work)
  3. Enter the customizer by clicking the “Customize” link located at the admin bar.
  4. Locate the section named “Category Posts Shortcode” and click it (it should be at the bottom of the sections list)
  5. Voila, you should see now all the settings in exactly the same way and functionality as you see them when configuring the widget when it is part of the sidebar.
  6. Once you are happy with the changes, just save and the new settings will be saved

The shortcode itself do not change as a result of the manipulation in the customizer and there is no need to add to it any attributes which will clutter your content.


  • You can have only one Shortcode per post. This is just a current code limitation, and we will probably remove this restriction if there is demand for more then one.
  • There is no simple way to duplicate the settings of one Shortcode into a short code in a different post
  • There are all kinds of plugins that let you “include” Shortcodes in all kinds of places. The result of using this shortcode with them are unexpected. We might look into how to integrate with specific plugins if there will be a lot of demand.


26 Replies to “Use Shortcode to add “Category Posts Widget” to the content”

    1. Hi Dave,

      thanks for your comment and thank you for your praise.
      It’s very good if you telling us that there is interest to use multiple widgets on a page. We basically just waiting to get notify from our users and if they ask us.
      So in principle, we will soon support multiple widgets per page. It is only a matter of time.

      I have just used it at a customer site and it begs the question to place the widget up and down on one side. It was then but not absolutely necessary. Because I placed one in the widget area and one at the site content. At the moment enough.
      That means that we know and have also made it known that it can be placed at the moment only once.

      We are even a bit proud that configuring via WordPress Customizer and Live Preview works so well. It has also prepared a lot of work!

      If you want you can send us something about how you used the widget?


  1. Hi,
    I followed all the steps as descibed above but the menu item ‘category post shortcode’ does not show up in the customizer. I can edit the category post widget via the customizer. Can you help?

    1. Which version do you use? The free version from Category Posts Widget or the premium version from Term and Category Based Posts Widget.
      You get this menu entry “Category Posts Shortcode” when you use the shortcode [catposts] (for the free version) or [termposts] (for the premium version) in the content. As it’s descriped above.

  2. Hi there. Can you please point me to some documentation on the shortcode parameters that are available for [catposts]? The customizer doesn’t work with my theme, apparently and I’d like to be able to filter by date, tag, category, add thumbnails, etc.

      1. I’m seeing this same issue, using tagDiv Newspaper Theme with visual composer. I am an admin. Is there a way to configure the shortcode manually?

    1. Hi Martin,

      There is no UI for it, but we use a filter “cpw_excerpt” to let users filter the generate excerpt if they want to write the code for it, and it is possible for you to write a small piece of code to utilize it and output the full content of the post instead of the excerpt.

  3. Hi there,

    this could be the exactly the PlugIn I’ve been searching for, but “Category Posts Shortcode” does not appear in my Customizer … Any ideas what’s wrong?

    1. I just saw, that heleen had the same problem last year. To answer the questions you asked her:

      I use the free version from Category Posts Widget.
      I have a page which uses [catposts name="my name"] and it shows a list of the last 10 recent posts, but there’s no menu entry in the Customizer.

      1. Hi Marion,

        Do you see the “customize” link in the toolbar when you edit the post/page? If not, do you use a pagebuilder?

  4. Yes, I see and use the Customizer-Link in the Toolbar.

    Well … I just wanted to make a screenshot for you and you won’t believe me: Suddenly the menu entry appeared! I swear it hasn’t been there! lol

    Damn … I look like an idiot now …

    Anyway: Thanks for your reply and this very nice PlugIn! 🙂

    1. And now it’s gone again and this leads me to the solution!
      FYI: My category-name has been too long. I shortened it and now it works!

  5. Hi, I’m having the same problem. I’m self-hosted, using the free version.
    My theme is build on Genesis.

    I can see the l the little [CP], I used in the blog post. When I review, I can see 20 links, with Recent Posts on the top. When I click on my customize button on top, I get my regular customize taps but NO Category Posts Shortcode.

    I would really love to figure this out, because the end result is exactly what I want in for my blog. I need to make this work. 😀

    Thank you,


    1. We could find the issue via Skype with the used page builder.

      We’re looking forward, if it works and hear again from you.

  6. Hello,

    I followed all of the steps listed above but am not seeing the menu item. To recap I:
    1) downloaded & activated free plug-in.
    2) inserted [catposts] in the page I want to show my posts by category
    3) went to preview the page and saw the code in the content area displaying the word “[catposts]”
    – I assume I shouldn’t be seeing the actual code 🙁
    4) Went to customizer and am unable to Category Posts Shortcode.

    1. Please don’t copy&past the shortcode from our page.
      Because you have more Html as you need with copy&past.

      Write the shortcode manually or use the button in the editor tool-bar +[cp].

Leave a Reply

Your email address will not be published. Required fields are marked *