Beginner's Guide for WordPress - Start your WordPress Blog in minutes.
Choosing the Best
WordPress Hosting
How to Easily
Install WordPress
WordPress Plugins
View all Guides

How to Display a WordPress Post only if it has a specific Custom Field

Last updated on by
Special WordPress Hosting offer for WPBeginner Readers
How to Display a WordPress Post only if it has a specific Custom Field

Recently one of our users asked us how to display WordPress posts only if a specific custom field was present. After replying back with the answer, we thought it would best if we share with everyone else, so the larger community can benefit from it as well.

You need to have a fair understanding of how WordPress loops work because we will call these parameters in a WordPress query.

The example code below will only show posts that have a custom field color present no matter what value the color field has. You would need to paste this loop code wherever you want to posts to show. Most likely in a custom WordPress page template.


// The Query to show a specific Custom Field

$the_query = new WP_Query('meta_key=color');

// The Loop
while ( $the_query->have_posts() ) : $the_query->the_post();



// Reset Post Data


Now if you want to show posts that has a custom field with a specific value, then you just have to change the query like this:

$the_query = new WP_Query( 'meta_value=blue' );

Now if you want to stress out the key and value for example you only want to pull posts that has a custom field key color and the value as blue, then your query code will look liks this:

$the_query = new WP_Query( array( 'meta_key' => 'color', 'meta_value' => 'blue' ) );

There are a lot more custom parameters that you can use while working on your sites. Just refer to the Codex page for WP_Query Parameters.

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi. Page maintained by Syed Balkhi.

WPBeginner's Video Icon
Our HD-Quality tutorial videos for WordPress Beginners will teach you how to use WordPress to create and manage your own website in about an hour. Get started now »


  1. ahmed says:

    i have a question sir if i want to display single post and custom fields then what i should do.
    i dont want to display the post with specific custom fields. i want to display all custom fields of post

  2. Dave101 says:

    Hi, thank for the useful tutorial. I have a question, in a wordpress website i set a meta value named “meta_country” and then i set every post with the country of the article, like “us”, “uk”, “fr”… Now I’m trying to add somewhere in the home of the blog a link that show list of all post with a specific country and a specific tag. For example all “UK” post tagged “APPLE”.
    I don’t understand how to do that, someone could help me?

  3. Максим Каминский says:

    great thanks, it help wery well!

  4. pjhooker says:


  5. Eduard Unruh says:

    omg finally THANKS!

  6. Mario M says:

    I wasnt able to generate any results unless I included “post_type” parameter into the query.

    ie: $the_query = new WP_Query(‘post_type=page&meta_key=color’);

  7. sacha says:

    Wonderful, just so simple and clean.
    Thank you.

  8. says:

    @ad Great question! I’m curious too.

  9. ad says:


    How could I show posts that DON’T have a specific Custom Field? Any idea?


    • tara tin says:

      as I know from php it must be meta_key!=’your key’

      ;just you need to know that “!” means “not”

  10. brunobruno2 says:

    Beatiful! Many thanks for sharing it. Works like a charm.

Add a Comment

We're glad you have chosen to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and all links are nofollow. Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.