Category Posts in Custom Menu


The default custom menu in WordPress only allows adding a link that leads to a list of posts and pages belonging to a taxonomy (category, tag, etc). If you want to list the posts and pages themselves and if you want WordPress to do this automatically for you, then I hope you will find this plugin useful.

Also works for custom taxonomies and custom post types
NEW: CPCM V3 now provides support for Full Site Editing with the Gutenberg Block Editor
WARNING: Coming from version 1.x? There are breaking changes, read the changelog before upgrading.

Using it

Enable the plugin and go to either Appearance > Menus or Appearance > Customize or Appearance > Editor. Add a category (or other taxonomy like tag or custom) to the menu. Next, you can choose if you would like to replace the category by the posts or pages themselves.

For each Category in your menu, you now have the following extra configuration options:

  • Replace by posts in the category y/n;
  • specify the (maximum) number of posts you want to show for this item (max 10);
  • their ordering ascending or descending by Title, Date or Menu Order;
  • specify the title for the menu items. For this you can use %post_title, %post_author and other wildcards, see ‘Other Notes > Wildcards’. Default value: %post_title


You can control the title of the menu items generated by the plug-in with the following wildcards:

  • %post_title
  • %post_author
  • %post_date for the unformatted post date: 2012-11-10 18:14:23
  • %post_date() for a formatted post date with the following default formatting: November 10th, 2012
  • %post_date(<your formatting here>) for custom date formatting. Example: %post_date(l jS \of F Y, h:i:s A). See for formatting options.
  • %post_date_gmt
  • %post_date_gmt()
  • %post_date_gmt(<your formatting here>)


  • Go to Appearance > Menu to enable/disable and set the options for the replacement of Category / Post Tag links by their posts.
  • Go to Appearance > Customize to enable/disable and set the options for the replacement of Category / Post Tag links by their posts. (Requires WordPress 5.4 or higher)
  • Go to Appearance > Editor to enable/disable and set the options for the replacement of Category / Post Tag links by their posts. (Requires WordPress 6.1 or higher)


Este plugin proporciona 1 bloque.

  • CPCM Navigation Link Extension


  1. Go to plugins in your dashboard and select «Add New»
  2. Search for «CPCM» or «Category Posts in Custom Menu»
  3. Install and Activate the plugin


How do I use it?

Here’s a walkthrough:

  1. Create a post with title «Post 1» and add a _new_ category «Category A»
  2. Save the post
  3. Go to Appearances > Menus (or via Appearance > Customize or Appearance > Editor, in WordPress 5.4 or higher)
  4. Add your category named «Category A»
  5. Open the menu item and check «Create submenu containing posts in this category.»
  6. Save the menu

If you now look at your website, «Category A» is replaced by «Post 1». Add additional posts to Category A and you will automatically see these additional posts in the menu.

Missing CSS classes

The CSS class ‘current-post-ancestor’ is not applied correctly. This is a bug in WordPress that I have reported here: This is not something I am able to fix in the plugin, it has to be fixed in WordPress. I’m sorry for the inconvenience.

Performance issues

The plugin is potentially very expensive, especially when you decide to build your entire menu out of nothing but category posts.

The solution would be to cache the menu using transients, as reported here

$my_cached_menu = get_transient( ‘my_cached_menu’);

if( $my_cached_menu === false )


$my_cached_menu = wp_nav_menu( … );

set_transient( «my_cached_menu_», $my_cached_menu, YEAR_IN_SECONDS );


echo $my_cached_menu;

Can’t see it working in any way

Problem: «I can’t see what effect it has had. Nothing has changed (not that I can see) in the Appearance > Menu/Customize/Editor pages. It’s just like before.»

If you are using a recent version of category Posts in Custom Menu and an updated version of WordPress, the problem can only occur due to your theme or other plugins conflicting with Category Posts in Custom Menu. Please disable all themes and plugins except CPCM; verify that the CPCM fields show; enable other plugins and themes one by one to determine which plugin/theme conflicts with CPCM.

Note: A theme must either call wp_nav_menu() or apply_filters( ‘wp_nav_menu_objects’, … ) for CPCM to be triggered.


31 de octubre de 2021
For reasons I cannot understand, Wordpress doesn’t have the possibility to display a list of Posts determined by Post Category into a Menu/navigation area. THIS PLUGIN DOES JUST THAT! Thank you so much for your effort – I hope you continuously will update this plugin for all the people wanting this very simple, but important function!
12 de noviembre de 2019
Funziona benissimo con la versione 5.2.4 di wordpress e anche con installazione MultiSite
Leer todas las 43 reseñas

Colaboradores y desarrolladores

«Category Posts in Custom Menu» es un software de código abierto. Las siguientes personas han colaborado con este plugin.


Traduce «Category Posts in Custom Menu» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios


Verified compatibility with WordPress 6.6


Now provides support for Full Site Editing with the Gutenberg Block Editor.
Dropped support for WordPress 4.x, plugin now requires WordPress 5.4 or higher.
Verified compatibility with WordPress 6.5


Verified compatibility with WordPress 6.4.


Free version now also supports sorting by Menu Order.


Verified compatibility with WordPress 6.3.
Also re-verified compatibility with older versions: Tested against 4.9.23 and 5.9.7

New functionality:

  • Menus can now also be managed via Appearance > Customize (Requires WordPress 5.4 or higher)


WARNING: Version 2.0 has breaking changes! See changelog.

Bugfix: On some mobile themes, the dropdown caret did not show. (As reported here:, and here:

Split Free and Premium version:

  • Premium has extra wildcards that Free doesn’t have.
  • Premium allows expanding unlimited posts; Free is limited to 10 posts.
  • Premium allows preserving the original menu item; Free always removes the category to replace it by the posts below it.
  • Premium allows filtering out the subcategories; Free always returns posts in subcategories when the parent category is selected
  • Premium supports HTML in the label field; Free only supports plaintext.
  • Premium offers hooks to extend the plugin functionality; Free does not.


Now compatible with WordPress 5.7.
If you are on a WordPress version between 4.7 and 5.7.2, when encountering issues please report the WordPress version you’re running.


  • Rename __empty to custom_empty to suppress PHP 7.0 validation warning as reported here:
  • Add another sample extension (from github)
  • Update readme to reflect that it’s PHP7.0 compatible, as mentioned here:


  • Hide the options when ‘Create submenu …’ is not checked, thanks for contribution by websevendev
  • Fix compatibility issue with 4.7, resulting in options not being shown.


  • Allow users to plug-in their own wildcards to facilitate
  • Edit readme to explain usage of the custom wp_nav_menu_item_custom_fields that several plugin authors have been using.
  • Add example implementation to the sample extension that shows how to extend the CSS classes of the menu items
  • Unit tests


  • Only commit meta data for menu items that actually had a CPCM checkbox, reported here
  • Set default skip parameter to 0, as reported here


  • Fixed serious bug in versioning, which resulted in version 1.1 having no settings at all anymore. This fix has been tested with both both the upgrade path 1.0.1 -> 1.2 and upgrade path 1.0.1 -> 1.1 -> 1.2, both upgrade paths should be fined now. My sincere apologies to all who experienced this issue.
  • Fixed debug errors as reported here


  • Process custom fields last, so that users cannot override the built-in options like %post_featured_image with a custom field named «featured_image». As reported here
  • Allow others to extend my CPCM plugin with their own fields. Also includes a sample that shows how to do this.
  • Some comments and code formatting
  • Introduced plugin versioning in code in order to perform data conversion
  • Converted «cpcm-» custom fields to «_cpcm-» so that they don’t show on post edit pages and the like.
  • Update contact information
  • Ensure that excluding subcategories now also works for custom taxonomies. Only show the dropdown for hierarchical taxonomies. (Tags no longer show ‘Subcategory posts’ dropdown.)
  • Add custom CSS classes, as suggested here


  • Added hook wp_nav_menu_item_custom_fields for compatibility with other plug-ins adding fields to the Appearances > Menus page.
  • Fix for CSS class bugs reported by brangelo in
  • Bugfix: normal menu items that were below a menu item removed by cpcm, are now repositioned in the menu correctly.
  • Bugfix for subcategories with a single post with setting remove=»only if empty»: «For example, I have a parent category A with sub categories A1, A2 and A3. I have all sub categories set to remove only if there are no posts. Subcat A1 displays with submenu of posts (2), subcats A2 and A3 do not display and their posts (1 each) show directly under the parent as posts links.»


  • Bugfix: Correctly set the menu item parents. Relevant when nesting categories with ‘Create submenu’ checked.
  • First implementation (WIP) for request:
    When the menu item is marked as remove «always» or «only if empty» and there was one post, then make sure that any childen of the menu item become children of this single post.
  • Implement skip-parameter
  • Implemented exclusion of subcategories, useful alternative to


  • Fixed You can now specify 0 in ‘Number of posts’. That way, the category can be shown/hidden based on whether it is empty or not.
  • Fixed Forward slash is now accepted in date formatting.


  • Fix due to variable $string that has been moved out of the global scope in new WordPress release.


  • Fix
  • Fix
  • Add support for auto-generated image tags, see


  • Fixed bug introduced in 0.9.1 with respect to old PHP versions (5.2 and before)
  • Introduced an extra ordering option ‘Menu Order’, as suggested here:


  • Edits for strict mode (
  • Add thumbnail option with posts (
  • PHP 5.5 preg_replace() /e modifier deprecated (


  • Fixed CSS ‘active’ class problem: CSS classes are no longer copied from the parent menu item to the menu item for the posts/pages.


  • Added the option to keep or remove the original menu item. Initially, the original menu item was replaced by the list of its posts, but now you can choose for yourself whether this should be done (always / only if there are no posts / never)


  • Bugfix: Fixed invalid argument error reported by macrocurio in Plugin Support.


  • Bugfix: Link Target, CSS Classes, Link Relationship (XFN) and Description weren’t inherited from the original menu item. They are now.


  • Added support for custom post types
  • Fixed user_data bug
  • Added date formatting options


  • Added a bunch of wildcards: %post_feat_image (url only), %post_excerpt, %post_url, %post_date, %post_date_gmt, %post_status, %post_modified, %post_modified_gmt, %post_comment_count


  • Enable custom taxonomies.
  • Change plugin URL.


  • Fix plugin bug for Tags, probably related to 3.2.2 update.
  • Edit documentation
  • Change some CSS to show checkbox next to label instead of above it.
  • Edit text in menu item block to clarify use of custom fields.


  • Extended the plugin for use of custom fields. Use a custom field with name ‘my field’ with wildcard %post_my_field. Note that if the post does not have this custom field, the wildcard is removed (it is not replaced by anything).


  • Extended the plugin to post tags. Note that the plugin name has unfortunately not been changed to reflect this extension.

Added checkboxes, dropdowns and text fields to Appearance > Menu. It is now possible to:

  • Enable/disable per taxonomy item whether you want to replace it by its posts
  • Specify the (maximum) number of posts that should be displayed.
  • Specify the ordering (Descending/Ascending) and the field to order by (ID, title, etc..)
  • Set a title for the menu items. For this you can use the wildcards %post_title and %post_author.