Custom post type queries in Wordpress

Introduction

Custom post type queries let you get specific groups of content in WordPress. This helps you show only the posts you want, like products or events.

You want to list all books if you have a 'book' post type.

You want to show only upcoming events from an 'event' post type.

You want to display portfolio items separately from blog posts.

You want to filter posts by a custom post type on a page.

You want to create a custom archive page for a special content type.

Syntax

Wordpress

$query = new WP_Query([
  'post_type' => 'your_post_type',
  'posts_per_page' => 5,
  'order' => 'ASC',
  'orderby' => 'date',
  // other query parameters
]);

Replace 'your_post_type' with the slug of your custom post type.

WP_Query returns posts matching your criteria, which you can loop through.

Examples

Get the latest 5 posts from the 'book' custom post type.

Wordpress

$query = new WP_Query([
  'post_type' => 'book',
  'posts_per_page' => 5
]);

Get all 'event' posts ordered by date from oldest to newest.

Wordpress

$query = new WP_Query([
  'post_type' => 'event',
  'orderby' => 'date',
  'order' => 'ASC'
]);

Get posts from both 'book' and 'movie' post types, up to 10 posts.

Wordpress

$query = new WP_Query([
  'post_type' => ['book', 'movie'],
  'posts_per_page' => 10
]);

Sample Program

This code gets the 3 newest posts from the 'product' custom post type and prints their titles line by line. If no products exist, it shows a message.

Wordpress

<?php
// Query 3 latest 'product' posts
$query = new WP_Query([
  'post_type' => 'product',
  'posts_per_page' => 3
]);

if ($query->have_posts()) {
  while ($query->have_posts()) {
    $query->the_post();
    echo get_the_title() . "\n";
  }
} else {
  echo "No products found.";
}
wp_reset_postdata();
?>

Important Notes

Always call wp_reset_postdata() after a custom query to restore global post data.

You can combine custom post type queries with other filters like taxonomy or meta queries.

Use pre_get_posts hook to modify main queries for custom post types if needed.

Summary

Custom post type queries help you get specific content types in WordPress.

Use WP_Query with the post_type parameter to fetch posts.

Loop through results and reset post data after to keep WordPress working smoothly.

Practice

1. What is the main purpose of using post_type in a WP_Query in WordPress?

easy

A. To fetch posts of a specific custom post type

B. To change the theme of the website

C. To update the WordPress core version

D. To delete all posts from the database

Solution

1. Step 1: Understand WP_Query parameters

   The post_type parameter in WP_Query specifies which type of posts to fetch, such as posts, pages, or custom types.

2. Step 2: Identify the purpose of post_type

   It filters the query to only return posts of the given type, allowing you to get custom content.

3. Final Answer:

   To fetch posts of a specific custom post type -> Option A

4. Quick Check:

   post_type filters posts by type = A [OK]

Hint: Remember: post_type selects which content type to get [OK]

Common Mistakes:

• Confusing post_type with theme or plugin settings
• Thinking post_type deletes or updates posts
• Using post_type to change site appearance

2. Which of the following is the correct way to query a custom post type named 'product' using WP_Query?

easy

A. new WP_Query(array('post_type' => 'product'));

B. new WP_Query('post_type' = 'product');

C. WP_Query('post_type' => 'product');

D. new WP_Query(array('posttype' => 'product'));

Solution

1. Step 1: Check WP_Query syntax

   The correct syntax uses new WP_Query(array('post_type' => 'product')) with an associative array and the correct key post_type.

2. Step 2: Identify errors in other options

   new WP_Query('post_type' = 'product'); uses wrong assignment syntax, C misses new keyword, and D misspells post_type.

3. Final Answer:

   new WP_Query(array('post_type' => 'product')); -> Option A

4. Quick Check:

   Correct array syntax with 'post_type' key = B [OK]

Hint: Use new WP_Query with array and 'post_type' key [OK]

Common Mistakes:

• Using '=' instead of '=>' in array
• Omitting 'new' keyword
• Misspelling 'post_type' as 'posttype'

3. Given the following code, what will be the output if there are 3 'event' posts?

 $query = new WP_Query(array('post_type' => 'event'));
 if ($query->have_posts()) {
   while ($query->have_posts()) {
     $query->the_post();
     echo get_the_title() . ', ';
   }
 }
 wp_reset_postdata();

medium

A. Syntax error due to missing semicolons

B. No output because 'event' is not a default post type

C. Only the first event post title printed

D. Titles of all 3 event posts separated by commas

Solution

1. Step 1: Understand WP_Query loop behavior

   The loop runs while have_posts() returns true, iterating over all posts of type 'event'.

2. Step 2: Output titles of all posts

   Inside the loop, get_the_title() prints each post's title followed by a comma, so all 3 titles appear separated by commas.

3. Final Answer:

   Titles of all 3 event posts separated by commas -> Option D

4. Quick Check:

   Loop prints all titles = C [OK]

Hint: Loop with have_posts() prints all matching posts [OK]

Common Mistakes:

• Assuming only default post types work
• Thinking loop prints only one post
• Confusing syntax errors with correct code

4. Identify the error in this custom post type query code:

 $args = array('post_type' => 'book');
 $query = WP_Query($args);
 if ($query->have_posts()) {
   while ($query->have_posts()) {
     $query->the_post();
     the_title();
   }
 }
 wp_reset_postdata();

medium

A. Using the_title() inside the loop is invalid

B. Incorrect post_type name 'book'

C. Missing 'new' keyword before WP_Query instantiation

D. Missing wp_reset_postdata() call

Solution

1. Step 1: Check WP_Query instantiation

   WP_Query must be instantiated with the new keyword. The code misses new before WP_Query($args).

2. Step 2: Verify other parts

   The post_type 'book' is valid if registered, wp_reset_postdata() is present, and the_title() is valid inside the loop.

3. Final Answer:

   Missing 'new' keyword before WP_Query instantiation -> Option C

4. Quick Check:

   WP_Query needs 'new' keyword = D [OK]

Hint: Always use 'new' when creating WP_Query objects [OK]

Common Mistakes:

• Forgetting 'new' keyword
• Assuming post_type names are always wrong
• Thinking wp_reset_postdata() is optional

5. You want to query a custom post type 'movie' but only show posts published in 2023. Which WP_Query argument array correctly achieves this?

hard

A. { 'post_type' => 'movie', 'year' => 2023 }

B. { 'post_type' => 'movie', 'date_query' => array(array('year' => 2023)) }

C. { 'post_type' => 'movie', 'meta_key' => 'year', 'meta_value' => 2023 }

D. { 'post_type' => 'movie', 'post_status' => '2023' }

Solution

1. Step 1: Understand filtering by date in WP_Query

   To filter posts by year, use the date_query parameter with an array specifying the year.

2. Step 2: Evaluate each option

   { 'post_type' => 'movie', 'date_query' => array(array('year' => 2023)) } correctly uses date_query with year 2023. { 'post_type' => 'movie', 'year' => 2023 } uses an invalid 'year' key. { 'post_type' => 'movie', 'meta_key' => 'year', 'meta_value' => 2023 } filters by meta fields, not post date. { 'post_type' => 'movie', 'post_status' => '2023' } misuses post_status.

3. Final Answer:

   { 'post_type' => 'movie', 'date_query' => array(array('year' => 2023)) } -> Option B

4. Quick Check:

   Use date_query for year filtering = A [OK]

Hint: Use date_query array to filter posts by year [OK]

Common Mistakes:

• Using 'year' directly instead of date_query
• Confusing meta_key with post date
• Misusing post_status for date filtering