{"id":100066,"date":"2025-02-05T18:20:08","date_gmt":"2025-02-06T00:20:08","guid":{"rendered":"https:\/\/wpengine.com\/?post_type=resource&p=100066"},"modified":"2025-02-11T18:21:37","modified_gmt":"2025-02-12T00:21:37","slug":"wp_query-in-wordpress","status":"publish","type":"resource","link":"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/","title":{"rendered":"Perform Queries: WordPress WP_Query"},"content":{"rendered":"\n

The database<\/a> that feeds your WordPress website is full of valuable information. This is what makes it possible to filter your posts and pages by many different variables. If what you want to display is not part of your theme, however, there are other ways of using that data. <\/p>\n\n\n\n

This is where WP_Query<\/a> comes in. This is a PHP class<\/a> that makes use of a wide variety of parameters. Consequently, it enables you to pull data from the WordPress database for use or display on your website. <\/p>\n\n\n\n

In this article, we\u2019ll provide a deeper understanding of the WP_Query class and how it can be used. We\u2019ll also walk you through some important steps to follow when using it. If you\u2019re ready, let\u2019s dive right in! <\/p>\n\n\n\n\n\n

What is WP_Query?<\/h2>\n\n\n\n

As we mentioned, WP_Query is a PHP class used by the WordPress database. This particular class can do several things, but primarily it\u2019s used to pull posts from the database. <\/p>\n\n\n\n

As its name indicates, it makes a query based on the criteria you set for it. Since there are a lot of parameters<\/a> you can use with WP_Query in WordPress, you can pull and display posts in a number of unique ways. We\u2019ll explore those options in greater detail later in this post.<\/p>\n\n\n\n

How to Use WP_Query<\/h2>\n\n\n\n

Even if you\u2019re just learning the various aspects of the WordPress codebase, WP_Query is a good class to get started with. Now, let\u2019s break down four different ways you can use it on your website. <\/p>\n\n\n\n

1. Get Started with a Custom Loop <\/h3>\n\n\n\n

One of the best ways to get to know the WP_Query call is through the WordPress Loop<\/a>. If you\u2019re not familiar with what the Loop is, it\u2019s an important concept to read up on.<\/p>\n\n\n\n

The Loop is what calls to the database asking for post content, and displays the data that is returned. It also functions based on set parameters, such as how many posts you want your site to display on a single page (something you can configure in your Settings > Reading<\/em> menu).<\/p>\n\n\n\n

The very basics of the Loop look like this:<\/p>\n\n\n\n

<?php
if ( have_posts() ) :
    while ( have_posts() ) : the_post();
        \/\/ Display post content
    endwhile;
endif;
?><\/code><\/p>\n\n\n\n

This simple statement is essentially saying that if there are posts, they should be displayed. Of course, you can add a wide variety of template tags<\/a> to this foundation, in order to create the display you want.<\/p>\n\n\n\n

You can also insert WP_Query into the Loop. This enables you to place parameters on what posts will be returned. Let\u2019s break down what that would look like: <\/p>\n\n\n\n

<?php

\/\/ The Query
$the_query = new WP_Query( $args );

\/\/ The Loop
if ( $the_query->have_posts() ) {
    echo '<ul>';
    while ( $the_query->have_posts() ) {
        $the_query->the_post();
        echo '<li>' . get_the_title() . '<\/li>';
    }
    echo '<\/ul>';
} else {
    \/\/ no posts found
}
\/* Restore original Post Data *\/
wp_reset_postdata();<\/code><\/p>\n\n\n\n

You\u2019ll see the same if\/while<\/em> statements from the basic Loop, but there is an additional WP_Query string. Whatever parameters are set here will determine what posts will be displayed. <\/p>\n\n\n\n

For example, if you wanted to exclude a certain author<\/a> from a list of posts, you could do that in the Loop with WP_Query: <\/p>\n\n\n\n

$query = new WP_Query( array( 'author' => -12 ) );<\/code><\/p>\n\n\n\n

By placing this in the Loop, your displayed posts would no longer include the user with the author number of 12.<\/p>\n\n\n\n

The number of parameters<\/a> you can use with this method are just about endless. You can include category information<\/a> as well as advanced taxonomies<\/a>, just to give two examples. <\/p>\n\n\n\n

2. Arguments: The Backbone of Custom Queries in WordPress<\/h3>\n\n\n\n

In the previous example, you may have noticed \u201c($args)\u201d as a part of the string. This is a vital part of the query that refers to the included “arguments.” It tells the database exactly what to include in the returned data. <\/p>\n\n\n\n

Essentially, these arguments can be set up to determine the exact results you want to display. Arguments can be used to change the value of variables as well. For example, if you want to change how your list of categories appears on the page, you can use an argument. <\/p>\n\n\n\n

Your argument will define an array of variables and values. So if you want to, you can use an argument to define an array and tell your database to present the categories in descending order. Additionally, you can use the same method to exclude any categories that don\u2019t contain posts. <\/p>\n\n\n\n

3. Parameters in WP_Query: Category, Tag, and More <\/h3>\n\n\n\n

Up to this point, we\u2019ve only mentioned parameters in passing. At this point, let\u2019s look closer at what they can actually do. Their primary function is to enable you to pull custom-designed collections of posts. <\/p>\n\n\n\n

One example of a parameter<\/a> that can be used in the header of your site is the Category parameter<\/a>. You can use this to specify specific categories for display. This is done by providing the relevant category number or slug. <\/p>\n\n\n\n

Additionally, you can do the same thing with the Tag parameter<\/a>. Of course, the Category and Tag parameters are really just the tip of the iceberg when it comes to using WP_Query. <\/p>\n\n\n\n

4. Modify Objects with Methods and Properties <\/h3>\n\n\n\n

While it\u2019s not recommended to directly alter the properties of a class<\/a> like WP_Query, you can interact with them by using methods<\/a>. Essentially, methods are like functions<\/a>, while properties are the equivalent of variables<\/a>. <\/p>\n\n\n\n

WP_Query has many properties<\/a>. These range from simple \u201c$posts\u201d properties to more complicated ones. Whatever method is used to interact with them, data will be returned based on the parameters you choose to put in place. <\/p>\n\n\n\n

WP_Query vs. query_posts() in WordPress<\/h2>\n\n\n\n

It\u2019s worth noting there is another way to modify the main query on your page. This is the query_posts() function. While this can work in a similar way to WP_Query, it can also be very problematic. <\/p>\n\n\n\n

The WordPress Code Reference<\/a> even strongly advises that you do not use this function inside your website\u2019s main Loop. It\u2019s also best to avoid it in plugins and themes. This is because it will completely override your main query. <\/p>\n\n\n\n

The WP_Query class is preferred, because you can also “reset” the main Loop after you run a query. Since WP_Query allows you to run multiple queries in a loop, you\u2019ll want to understand how to implement the wp_reset_postdata<\/a> function as well.<\/p>\n\n\n\n

If you\u2019ve embedded a secondary loop inside the main WordPress Loop, the reset function will be placed at the end and look like this: <\/p>\n\n\n\n

<?php wp_reset_postdata(); ?><\/code><\/p>\n\n\n\n

This will restore the default template tags, and you\u2019ll be back to how things were before your secondary loop was initiated. <\/p>\n\n\n\n

Customize Your WordPress Site with WP Engine <\/h2>\n\n\n\n

Being able to make adjustments to how items are displayed on your website is just one of the benefits of using WordPress. Understanding WP_Query and leveraging the tools provided on the developer resources<\/a> page can help you build truly customized websites. <\/p>\n\n\n\n

Here at WP Engine, we\u2019re passionate about making sure you have the resources and high-quality hosting for WordPress sites<\/a> so you can focus on building and managing engaging websites. Check out our solutions and hosting plans for WordPress sites<\/a> today!\u00a0<\/p>\n","protected":false},"excerpt":{"rendered":"

The database that feeds your WordPress website is full of valuable information. This is what makes it possible to filter your posts and pages by many different variables. If what you want to display is not part of your theme, however, there are other ways of using that data.  This is where WP_Query comes in.…<\/span><\/span><\/p>\n","protected":false},"author":177,"featured_media":146528,"template":"","resource-topic":[901],"resource-role":[896,897],"resource-type":[916],"class_list":["post-100066","resource","type-resource","status-publish","has-post-thumbnail","hentry"],"yoast_head":"\nHow to Use WP_Query in WordPress<\/title>\n<meta name=\"description\" content=\"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress.\" \/>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Use WP_Query in WordPress\" \/>\n<meta property=\"og:description\" content=\"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress with WP Engine.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/\" \/>\n<meta property=\"og:site_name\" content=\"WP Engine\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/wpengine\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-12T00:21:37+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2020\/02\/query-header.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1100\" \/>\n\t<meta property=\"og:image:height\" content=\"500\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"How to Use WP_Query in WordPress\" \/>\n<meta name=\"twitter:description\" content=\"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress with WP Engine.\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2020\/02\/query-header.png\" \/>\n<meta name=\"twitter:site\" content=\"@wpengine\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/\",\"url\":\"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/\",\"name\":\"How to Use WP_Query in WordPress\",\"isPartOf\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\"},\"datePublished\":\"2025-02-06T00:20:08+00:00\",\"dateModified\":\"2025-02-12T00:21:37+00:00\",\"description\":\"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress.\",\"breadcrumb\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/wpengine.com\/case-studies\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resources\",\"item\":\"https:\/\/wpengine.com\/case-studies\/resources\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Perform Queries: WordPress WP_Query\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\",\"url\":\"https:\/\/wpengine.com\/case-studies\/\",\"name\":\"WP Engine\",\"description\":\"Managed Hosting for WordPress\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/aba73ed4c15eda43b5fd78844ec31fad\",\"name\":\"Samantha Rodriguez\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/933722cf8761e0c08fbced6085998032df460c5ecfa2481d9cd16f569f3da2c1?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/933722cf8761e0c08fbced6085998032df460c5ecfa2481d9cd16f569f3da2c1?s=96&d=mm&r=g\",\"caption\":\"Samantha Rodriguez\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Use WP_Query in WordPress","description":"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress.","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"How to Use WP_Query in WordPress","og_description":"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress with WP Engine.","og_url":"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/","og_site_name":"WP Engine","article_publisher":"https:\/\/www.facebook.com\/wpengine","article_modified_time":"2025-02-12T00:21:37+00:00","og_image":[{"width":1100,"height":500,"url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2020\/02\/query-header.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_title":"How to Use WP_Query in WordPress","twitter_description":"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress with WP Engine.","twitter_image":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2020\/02\/query-header.png","twitter_site":"@wpengine","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/","url":"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/","name":"How to Use WP_Query in WordPress","isPartOf":{"@id":"https:\/\/wpengine.com\/case-studies\/#website"},"datePublished":"2025-02-06T00:20:08+00:00","dateModified":"2025-02-12T00:21:37+00:00","description":"WP_Query allows users to perform complex queries to retrieve data from the WordPress database. Learn how to use WP_Query in WordPress.","breadcrumb":{"@id":"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/wpengine.com\/case-studies\/resources\/wp_query-in-wordpress\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/wpengine.com\/case-studies\/"},{"@type":"ListItem","position":2,"name":"Resources","item":"https:\/\/wpengine.com\/case-studies\/resources\/"},{"@type":"ListItem","position":3,"name":"Perform Queries: WordPress WP_Query"}]},{"@type":"WebSite","@id":"https:\/\/wpengine.com\/case-studies\/#website","url":"https:\/\/wpengine.com\/case-studies\/","name":"WP Engine","description":"Managed Hosting for WordPress","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/aba73ed4c15eda43b5fd78844ec31fad","name":"Samantha Rodriguez","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/933722cf8761e0c08fbced6085998032df460c5ecfa2481d9cd16f569f3da2c1?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/933722cf8761e0c08fbced6085998032df460c5ecfa2481d9cd16f569f3da2c1?s=96&d=mm&r=g","caption":"Samantha Rodriguez"}}]}},"acf":[],"grid_image_url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2020\/02\/query-grid.png","media-type":{"term_id":916,"name":"Article","slug":"article"},"role":"<strong>Roles:<\/strong> Developer, Freelancer","topic":"<strong>Topics:<\/strong> WordPress","_links":{"self":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource\/100066","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource"}],"about":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/types\/resource"}],"author":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/users\/177"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media\/146528"}],"wp:attachment":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media?parent=100066"}],"wp:term":[{"taxonomy":"resource-topic","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-topic?post=100066"},{"taxonomy":"resource-role","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-role?post=100066"},{"taxonomy":"resource-type","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-type?post=100066"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}