get_post_types( array|string $args = array(), string $output = ‘names’, string $operator = ‘and’ ): string[]|WP_Post_Type[]

User Contributed Notes

1. Skip to note 10 content

   tleifj 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 18You must log in to vote on the helpfulness of this note

   Argument values for $args include:

   • public – Boolean. If true, only public post types will be returned.
   • publicly_queryable – Boolean
   • exclude_from_search – Boolean
   • show_ui – Boolean
   • capability_type
   • hierarchical
   • menu_position
   • menu_icon
   • permalink_epmask
   • rewrite
   • query_var
   • show_in_rest – Boolean. If true, will return post types whitelisted for the REST API
   • _builtin – Boolean. If true, will return WordPress default post types. Use false to return only custom post types.
2. Skip to note 11 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   Output a list of only custom post types which are public
   By setting '_builtin' to false, we exclude the WordPress built-in public post types (post, page, attachment, revision, and nav_menu_item) and retrieve only registered custom public post types.

   <?php
   $args = array(
      'public'   => true,
      '_builtin' => false
   );
    
   $output = 'names'; // 'names' or 'objects' (default: 'names')
   $operator = 'and'; // 'and' or 'or' (default: 'and')
    
   $post_types = get_post_types( $args, $output, $operator );
    
   if ( $post_types ) { // If there are any custom public post types.
    
       echo '<ul>';
    
       foreach ( $post_types  as $post_type ) {
           echo '<li>' . $post_type . '</li>';
       }
    
       echo '</ul>';
    
   }
   ?>

   • The _builtin option also ignores the following: custom_css, customize_changeset, oembed_cache, user_request, wp_block, wp_template.

     Code Muffin 3 years ago
3. Skip to note 12 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Retrieve a named post type as an object
   This example uses the 'object' output to retrieve the post type called ‘movies’ and display its name, singular name and menu icon (an URL):

   <?php
   $args = array(
    	'name' => 'movies',
   );
   
   $post_types = get_post_types( $args, 'objects' );
   
   foreach ( $post_types  as $post_type ) {
      echo '<p>Custom Post Type name: ' . $post_type->name . "<br />\n";
      echo 'Single name: ' . $post_type->labels->singular_name . "<br />\n";
      echo 'Menu icon URL: ' . $post_type->menu_icon . "</p>\n";;
   }
   ?>
4. Skip to note 13 content

   Md. Jwel Miah 6 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Get post types array with name => singular name

   function prefix_get_post_types() {
       $post_types = get_post_types([], 'objects');
       $posts = array();
       foreach ($post_types as $post_type) {
           $posts[$post_type->name] = $post_type->labels->singular_name;
       }
       return $posts;
   }

   You can use this function in a select dropdown option where user can select a post type form existing post types.
5. Skip to note 14 content

   Mostafa Soufi 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   Display the HTML dropdown list of Post Types.

   <?php
   // Get post types
   $args       = array(
   	'public' => true,
   );
   $post_types = get_post_types( $args, 'objects' );
   ?>
   
   <select class="widefat" name="post_type">
       <?php foreach ( $post_types as $post_type_obj ):
           $labels = get_post_type_labels( $post_type_obj );
           ?>
           <option value="<?php echo esc_attr( $post_type_obj->name ); ?>"><?php echo esc_html( $labels->name ); ?></option>
       <?php endforeach; ?>
   </select>
6. Skip to note 15 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Output a list of the names of all registered post types
   Uses 'names' as $output argument value.

   <?php
   
   $post_types = get_post_types( '', 'names' ); 
   
   echo '<ul>';
   	
   foreach ( $post_types as $post_type ) {
   
      echo '<li>' . $post_type . '</li>';
   }
   
   echo '</ul>';
   ?>
7. Skip to note 16 content

   Muhammad Ayoub 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Display the HTML dropdown list of Post Types, including custom post types

   <?php
   $post_types = get_post_types(array('public' => true), 'names', 'and');
   ?>
   <select class="" name="post_type">
     <?php
   
     foreach ($post_types  as $post_type) {
     ?>
       <option value="<?php echo esc_attr($post_type); ?>"><?php echo esc_html($post_type); ?></option>
     <?php
     }
     ?>
   </select>
   ?>
8. Skip to note 17 content

   Shashikant Yadav 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Remove specific post type

   $post_types = get_post_types( array( 'public' => true, '_builtin' => true ), 'names', 'and' );
   // remove attachment from the list
   unset( $post_types['attachment'] );
   echo '<ul>';
   foreach ( $post_types  as $post_type ) {
       echo '<li>' . $post_type . '</li>';
   }
   echo '</ul>';

   • This only removes the attachment post type from the $post_types variable; it does not actually unregister (“remove”) the attachment post type.

     crstauf 4 years ago
9. Skip to note 18 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

   Default Usage
   Retrieves the names (in an array) of all built-in and custom post types.

   <?php $post_types = get_post_types(); ?>