Show Custom Post Types in Category Archive Page

November 13, 2015 -

By default WordPress custom post types do not appear in a category or tag archive page, to change this behaviour and display the custom post type you can add this filter/function to your themes functions.php file.

function themeprefix_show_cpt_archives( $query ) {
 if( is_category() || is_tag() && empty( $query->query_vars['suppress_filters'] ) ) {
 $query->set( 'post_type', array(
 'post', 'nav_menu_item', 'custom-post-type-name'
 ));
 return $query;
 }
}
add_filter( 'pre_get_posts', 'themeprefix_show_cpt_archives' );

Just add your custom post type name to suit, or to add more than one just comma separate the names.

This uses the pre_get_posts filter – Ref

Related Posts:

Categorized WordPress Tagged , ,

10 Comments

  1. Arjun on January 14, 2022 at 7:20 pm

    This tutorial is a gem! I have been lost on the internet trying to find a solution for this. By why should wp disable this by default. It’s so frustrating. Thanks a lot for this

    Reply
  2. Erica on March 10, 2021 at 5:28 pm

    Didn’t work for me as well

    Reply
  3. B on August 5, 2020 at 8:33 am

    So, I think that the comment from Steve on May 17, 2016 at 5:06 pm is correct. This code caused my dashboard to crash when filtering categories. Please fix this so others don’t have the same problem.

    Reply
  4. B on March 2, 2020 at 7:46 am

    Thank you so much! This was exactly what I needed. I really appreciate it.

    Reply
  5. nate simpson on October 25, 2019 at 2:05 am

    not working for me?

    Reply
  6. Reasad Azim on January 25, 2018 at 11:25 am

    That works ! Thank you.

    Reply
  7. Steve on May 17, 2016 at 5:06 pm

    Just an FYI that you should not pass an array of post types to $query->set(‘post_type’,array()) because it will throw an error/notice in php and cause issues with certain functionality. The second argument must be string/scalar.

    Take a look at: https://core.trac.wordpress.org/attachment/ticket/30013/30013.3.diff

    Reply
  8. Eric on July 7, 2015 at 3:20 pm

    Great! I stumbled across this post and it is a great help, thanks. BUT, there are some glitches with Recent Posts widget and nav menus (and I haven’t worked out how to fix them yet):

    In the archive view *with* ‘nav_menu_items’ in the query: the Recent Posts widget shows nav items (e.g. ‘Home’ and ‘Blog’ pages) which I don’t want.

    In the archive view *without* ‘nav_menu_items’ in the query: Recent Posts is right but these items are not shown on the nav menu, breaking the navigation.

    Also, CPT entries are listed in Recent Posts widget when viewing it on archive pages, but when viewing on other pages like the entry itself or the home/blog feed.

    In the hope that you’re still monitoring comments on this post can you give me any tweaks to fix this? :-)

    Reply
  9. Glenn Dixon on March 20, 2015 at 8:04 pm

    Neil,

    I just spent HOURS in a chat room getting help from several people trying to help me work around this very issue. Was converting plain WP w/ crazy amount of products, CPT’s, taxonomies, page templates, etc. Very custom, very ugly. Your post was the missing piece! Was getting very tired of seeing the same damned blank pages. If you lived here in Mexico I’d buy you a bottle of tequila!

    Thank you!

    Reply
    • Neil Gee on March 20, 2015 at 10:38 pm

      Next time I’m in Mexico I’ll hit you up.

      Reply

Leave all Comment