What are all the available parameters for query_posts?

The question:

The WordPress codex page for query_posts states that it does not cover all the parameters which query_posts takes:


This is not an exhaustive list yet. It is meant to show some of the more common things possible with setting your own queries

I couldn’t find a reference of all the parameters which are accepted by query_posts, though, even in just a simple list form. Is there a cheat-sheet or something similar available with this data?

The Solutions:

Below are the methods you can try. The first solution is probably the best. Try others if the first one doesn’t work. Senior developers aren’t just copying/pasting – they read the methods carefully & apply them wisely to each case.

Method 1

Below is everything from WordPress 3.0.1 found in the parse_query() function of /wp-includes/query.php (lines 1246-1550).
However, it’s possible for a plugin to add parameters and so a list can never be fully complete:

  • attachment
  • attachment_id
  • author
  • author_name
  • cat
  • category__and
  • category__in
  • category__not_in
  • category_name
  • comments_popup
  • day
  • error
  • feed
  • hour
  • m
  • minute
  • monthnum
  • name
  • order
  • orderby
  • p
  • page_id
  • page
  • paged
  • pagename
  • post__in
  • post__not_in
  • post_status
  • post_type
  • preview
  • robots
  • s
  • sentence
  • second
  • static
  • subpost
  • subpost_id
  • tag__and
  • tag__in
  • tag__not_in
  • tag_id
  • tag_slug__and
  • tag_slug__in
  • tag
  • taxonomy – (pre 3.1)
  • tb
  • term – (pre 3.1)
  • w
  • withcomments
  • withoutcomments
  • year

    Pre WP 3.1

  • meta_key
  • meta_value

    Since WP 3.1

  • fields
  • meta_query
  • tax_query

Method 2

If you can read PHP code, you can take a look at the function parse_query($query) in class WP_Query of file wp-includesquery.php

The supported arguments are all listed and managed there.

Method 3

I use the Codex page for WP_Query.

The list may not be exhaustive but it is useful, fairly comprehensive and up-to-date. I believe that WP_Query and query_posts share the same parameters.

All methods was sourced from stackoverflow.com or stackexchange.com, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0

Leave a Comment