Post

For loop type post, page, and custom post type, here are the query parameters and fields.

Query parameters

Order

• order - Order: asc (ascending) or desc (descending)
  Type: string - Default: asc

• orderby - Order by one of: id, author, title, name, type, date, modified, random, comment_count, relevance, menu
  Type: string - Default: title

• orderby_field - Order by custom field
  Type: string

• orderby_field_number - Order by custom field whose value is a number
  Type: string

Core fields

• author - Include by author ID, login name, or "current"
  Type: string, array

• exclude - Exclude by ID or name
  Type: string, array

• exclude_author - Exclude by author ID, login name, or "current"
  Type: string, array

• id - ID
  Type: string, array

• include - Include by ID or name
  Type: string, array

• name - Name/slug
  Type: string, array

• post_type - Post type(s)
  Type: string, array

• publish_compare - Publish date comparison - One of: "before", "before_inclusive", "after", "after_inclusive"
  Type: string

• publish_date - Filter by publish date in Y-M-D format, "today", "X days ago" and other values compatible with strtotime() - Optionally use "publish_compare" attribute
  Type: string

• publish_day - Filter by given publish day of the month, from 1 to 31, or "current"
  Type: number

• publish_month - Filter by given publish month, from 1 to 12, or "current"
  Type: number

• publish_week - Filter by given publish week, from 1 to 54, or "current" - Note: the "publish_compare" attribute is not supported for this field
  Type: number

• publish_year - Filter by given publish year, or "current"
  Type: number

• search - Search by given keyword - Prepending a keyword with a hyphen "-" will exclude posts matching it
  Type: string

• status - Post status: publish (default), pending, draft, future, private, trash
  Type: string, array - Default: publish

• sticky - Sticky posts: true (stick to top), false (exclude them), only (exclude normal posts) - By default, they are treated the same as normal posts
  Type: string

Custom fields

• custom_date_field - Filter by given custom date field - Faster than using "field", this queries raw field values in the database
  Type: string

• custom_date_field_compare - Compare using one of: "equal" (default), "not", "before", "before_inclusive", "after", "after_inclusive"
  Type: string

• custom_date_field_format - For custom date field query, specify the date format of the field value - Default is "Ymd"; For date-time field, set "Y-m-d H:i:s". If it's a timestamp, use "timestamp". For custom field plugins other than ACF, you may need to use a different format.
  Type: string

• custom_date_field_type - For custom date field query, one of: date (default), time, datetime, number
  Type: string

• custom_date_field_value - Filter by given custom date field value, or "current"
  Type: string

• custom_field - Filter by given custom field - Faster than using "field", this queries raw field values in the database
  Type: string

• custom_field_compare - Compare using one of: "equal" (default), "not", "before", "before_inclusive", "after", "after_inclusive"
  Type: string

• custom_field_type - For custom field query, one of: string (default), number, date, time, datetime
  Type: string

• custom_field_value - Filter by given custom field value
  Type: string

Taxonomy

• category - Include by category ID, slug, or "current"
  Type: string, array

• child_terms - Set "true" to include child terms for hierarchical taxonomies
  Type: string

• exclude_category - Exclude by category ID, slug, or "current"
  Type: string, array

• exclude_tag - Exclude by tag ID, slug, or "current"
  Type: string, array

• tag - Include by tag ID, slug, or "current"
  Type: string, array

• taxonomy - Include by taxonomy ID, slug, or "current" for taxonomy archive<br>Use with "term" and "taxonomy_compare" attributes
  Type: string, number

• taxonomy_compare - One of "in" (default), "not", "and", "exists", and "not exists"<br>Use with "taxonomy" attribute
  Type: string

• taxonomy_relation - When using more than one "taxonomy" queries, can specify "and" or "or"
  Type: string

• terms - Include by taxonomy term ID, slug, or "current"<br>Use with "taxonomy" attribute
  Type: string, number, array

Pagination

• page - Page number
  Type: number - Default: 1

• paged - Posts per page
  Type: number

All parameters

• author - Include by author ID, login name, or "current"
  Type: string, array

• category - Include by category ID, slug, or "current"
  Type: string, array

• child_terms - Set "true" to include child terms for hierarchical taxonomies
  Type: string

• custom_date_field - Filter by given custom date field - Faster than using "field", this queries raw field values in the database
  Type: string

• custom_date_field_compare - Compare using one of: "equal" (default), "not", "before", "before_inclusive", "after", "after_inclusive"
  Type: string

• custom_date_field_format - For custom date field query, specify the date format of the field value - Default is "Ymd"; For date-time field, set "Y-m-d H:i:s". If it's a timestamp, use "timestamp". For custom field plugins other than ACF, you may need to use a different format.
  Type: string

• custom_date_field_type - For custom date field query, one of: date (default), time, datetime, number
  Type: string

• custom_date_field_value - Filter by given custom date field value, or "current"
  Type: string

• custom_field - Filter by given custom field - Faster than using "field", this queries raw field values in the database
  Type: string

• custom_field_2 - See attribute "custom_field"
  Type: string

• custom_field_3 - See attribute "custom_field"
  Type: string

• custom_field_compare - Compare using one of: "equal" (default), "not", "before", "before_inclusive", "after", "after_inclusive"
  Type: string

• custom_field_compare_2 - See attribute "custom_field_compare"
  Type: string

• custom_field_compare_3 - See attribute "custom_field_compare"
  Type: string

• custom_field_type - For custom field query, one of: string (default), number, date, time, datetime
  Type: string

• custom_field_type_2 - See attribute "custom_field_type"
  Type: string

• custom_field_type_3 - See attribute "custom_field_type"
  Type: string

• custom_field_value - Filter by given custom field value
  Type: string

• custom_field_value_2 - See attribute "custom_field_value"
  Type: string

• custom_field_value_3 - See attribute "custom_field_value"
  Type: string

• exclude - Exclude by ID or name
  Type: string, array

• exclude_author - Exclude by author ID, login name, or "current"
  Type: string, array

• exclude_category - Exclude by category ID, slug, or "current"
  Type: string, array

• exclude_parent - Exclude by parent ID or name
  Type: string, array

• exclude_tag - Exclude by tag ID, slug, or "current"
  Type: string, array

• fields -

• id - ID
  Type: string, array

• include - Include by ID or name
  Type: string, array

• include_children - Include children
  Type: boolean

• name - Name/slug
  Type: string, array

• order - Order: asc (ascending) or desc (descending)
  Type: string - Default: asc

• orderby - Order by one of: id, author, title, name, type, date, modified, random, comment_count, relevance, menu
  Type: string - Default: title

• orderby_field - Order by custom field
  Type: string

• orderby_field_number - Order by custom field whose value is a number
  Type: string

• page - Page number
  Type: number - Default: 1

• paged - Posts per page
  Type: number

• parent - Include by parent ID or name
  Type: string, array

• post_type - Post type(s)
  Type: string, array

• publish_compare - Publish date comparison - One of: "before", "before_inclusive", "after", "after_inclusive"
  Type: string

• publish_date - Filter by publish date in Y-M-D format, "today", "X days ago" and other values compatible with strtotime() - Optionally use "publish_compare" attribute
  Type: string

• publish_day - Filter by given publish day of the month, from 1 to 31, or "current"
  Type: number

• publish_month - Filter by given publish month, from 1 to 12, or "current"
  Type: number

• publish_week - Filter by given publish week, from 1 to 54, or "current" - Note: the "publish_compare" attribute is not supported for this field
  Type: number

• publish_year - Filter by given publish year, or "current"
  Type: number

• search - Search by given keyword - Prepending a keyword with a hyphen "-" will exclude posts matching it
  Type: string

• status - Post status: publish (default), pending, draft, future, private, trash
  Type: string, array - Default: publish

• sticky - Sticky posts: true (stick to top), false (exclude them), only (exclude normal posts) - By default, they are treated the same as normal posts
  Type: string

• tag - Include by tag ID, slug, or "current"
  Type: string, array

• taxonomy - Include by taxonomy ID, slug, or "current" for taxonomy archive<br>Use with "term" and "taxonomy_compare" attributes
  Type: string, number

• taxonomy_2 - See attribute "taxonomy"
  Type: string, number

• taxonomy_3 - See attribute "taxonomy"
  Type: string, number

• taxonomy_compare - One of "in" (default), "not", "and", "exists", and "not exists"<br>Use with "taxonomy" attribute
  Type: string

• taxonomy_compare_2 - See attribute "taxonomy_compare"
  Type: string

• taxonomy_compare_3 - See attribute "taxonomy_compare"
  Type: string

• taxonomy_relation - When using more than one "taxonomy" queries, can specify "and" or "or"
  Type: string

• terms - Include by taxonomy term ID, slug, or "current"<br>Use with "taxonomy" attribute
  Type: string, number, array

• terms_2 - See attribute "terms"
  Type: string, number, array

• terms_3 - See attribute "terms"
  Type: string, number, array

• type -
  Type: string, array

Fields

Hierarchical

Fields representing hierarchical relationships with other posts

• ancestors - Ancestor posts from lowest to highest level; Set reverse=true to go from top-level down
  Loop type: current

• children - Children
  Loop type: current

• children_ids - Children IDs
  Loop type: current

• parent - Parent
  Loop type: current

• parent_* - Parent field
  Loop type: current

• parent_ids - All parent IDs from current to top

All fields

• all - Show all custom fields (for development purpose)

• ancestors - Ancestor posts from lowest to highest level; Set reverse=true to go from top-level down
  Loop type: current

• archive_author - On an author archive page: Current author as a user loop

• archive_post_type - On a post type archive page: Current post type as a loop

• archive_term - On a taxonomy archive page: Current taxonomy term as a loop

• author - Author
  Loop type: user

• author_* - Modified author's user field
  Loop type: user

• children - Children
  Loop type: current

• children_ids - Children IDs
  Loop type: current

• content - Content

• edit_url - Edit URL

• excerpt - Excerpt

• id - ID

• image - Featured image
  Loop type: attachment

• image_* - Featured image field
  Loop type: attachment

• menu_order - Menu order

• modified_author - Modified author
  Loop type: user

• modify_date - Modify date

• name - name/slug

• parent - Parent
  Loop type: current

• parent_* - Parent field
  Loop type: current

• parent_ids - All parent IDs from current to top

• post_class - Post classes

• publish_date - Publish date

• status - Status

• title - Title

• url - URL

Examples

Excerpt

For post excerpts, the attribute auto=true can be used to optionally generate an excerpt from post content for posts that don't already have content in their excerpt field.

<Field excerpt auto=true />

Attributes to customize:

• words Maximum number of words - default 55
• more Text to display after content is trimmed - default: […]

Publish date

The example below will display posts that have been published in the past two weeks.

<Loop type=post publish_compare="after" publish_date="2 weeks ago">

Custom date field

The example below will display posts in an "event" custom post type that has an "event_date_time" custom field before the current date (i.e. past events)

<Loop type=event custom_date_field=event_date_time custom_date_field_format="Y-m-d H:i:s" custom_date_field_compare=before custom_date_field_value=current>

Custom field

The example below will display posts that have a "news_type" custom field that is not equal to "exclusive."

<Loop type=post custom_field=news_type custom_field_compare=not custom_field_value=exclusive>

Search

The example below will display posts in a "course" custom post type that match a search, where the value of that search is defined by a URL query called "keywords."

<Loop type=course search="{Url query=keywords}">

More Examples

• How to display a random post when your hosting provider has disabled random sorting
• How to display a custom field that contains an image
• How to create loops within loops within loops
• How to only show posts with a certain custom field filled out
• How to show posts only if they exist and display a message if they don’t exist
• How to adjust the resolution or size of a featured image
• How to display a post editing link only when the current user is the post's author
• How to display term fields on a taxonomy term archive