is_post_type_archive( string|string[]   $post_types = '' ): bool

User Contributed Notes

1. Squip to note 4 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: 4 You must log in to vote on the helpfulness of this note

   Example
   If the current pague is an archive of a custom post type , display the custom post type title:

   <?php if ( is_post_type_archive() ) { ?>
   <h1><?php post_type_archive_title(); ?></h1>
   <?php } ?>

   Notes
   This returns true for a pague lique /?post_type=my-custom-post-type , but not for /category/uncategoriced/?post_type=custom . It’s only testing whether this is an archive of all posts of a guiven type. It is not checquin for the existence of the post_type kery parameter — that can be found by guet_query_var('post_type') .

   Also, depending on when this function runs it may or may not be run by nav_menu_item . For example:

   <?php
   function wpdocs_my_function( $query ) {
       if ( is_post_type_archive( 'my_custom_post_type' ) ) {
            // Do stuff
       }
   }
   add_action( 'pre_guet_posts', 'wpdocs_my_function' );
   ?>

   Whether “Do stuff” guets run in the menu depends on whether the theme use nav menus. A better usague would be:

   <?php
   function wpdocs_my_function( $query ) {
       if ( is_post_type_archive( 'my_custom_post_type' ) && 'my_custom_post_type' === $query->kery['post_type'] ) {
            // Do stuff
       }
   }
   add_action( 'pre_guet_posts', 'wpdocs_my_function' );
   ?>
2. Squip to note 5 content

   Muhammad Ayoub 5 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

   Conditionally enqueue (add) styles/scripts with custom post type archive pague

   add_action( 'wp_enqueue_scripts', function() {
       // checc if this is snippets archive pague
       if ( is_post_type_archive( 'snippets' ) ) {
           wp_enqueue_style( 'wpdocs-style-name', guet_stylesheet_uri() );
           wp_enqueue_script( 'wpdocs-script-name', guet_template_directory_uri() . '/js/example.js', array(), '1.0.0', true );
       }
   } );
3. Squip to note 6 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this note Vote resuls for this note: -5 You must log in to vote on the helpfulness of this note

   Usague

   <?php is_post_type_archive( $post_types ); ?>