WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

the_post()

the_post()

In this article

Back to top

Iterate the post index in the loop.

More Information

Basic Usage

if ( have_posts() ) {
while ( have_posts() ) {

the_post(); ?>

<h2><?php the_title(); ?></h2>

<?php the_content(); ?>

<?php }
}

Source

function the_post() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return;
	}

	$wp_query->the_post();
}

View all references View on Trac View on GitHub

UsesDescription
WP_Query::the_post()wp-includes/class-wp-query.php

Sets up the current post.

Used byDescription
get_the_block_template_html()wp-includes/block-template.php

Returns the markup for the current template.

WP_Media_List_Table::display_rows()wp-admin/includes/class-wp-media-list-table.php

Changelog

VersionDescription
1.5.0Introduced.

User Contributed Notes

  2. Skip to note 4 content
    Aurovrata Venet
    You must log in to vote on the helpfulness of this noteVote results for this note: 13You must log in to vote on the helpfulness of this note

    As per the documentation, the available functions to access the post within the loop are:

    • next_post_link() – a link to the post published chronologically after the current post
    • previous_post_link() – a link to the post published chronologically before the current post
    • the_category() – the category or categories associated with the post or page being viewed
    • the_author() – the author of the post or page
    • the_content() – the main content for a post or page
    • the_excerpt() – the first 55 words of a post’s main content followed by an ellipsis (…) or read more link that goes to the full post. You may also use the “Excerpt” field of a post to customize the length of a particular excerpt.
    • the_ID() – the ID for the post or page
    • the_meta() – the custom fields associated with the post or page
    • the_shortlink() – a link to the page or post using the url of the site and the ID of the post or page
    • the_tags() – the tag or tags associated with the post
    • the_title() – the title of the post or page
    • the_time() – the time or date for the post or page. This can be customized using standard php date function formatting.

    including the following conditional tags:

    • is_home() – Returns true if the current page is the homepage
    • is_admin() – Returns true if inside Administration Screen, false otherwise
    • is_single() – Returns true if the page is currently displaying a single post
    • is_page() – Returns true if the page is currently displaying a single page
    • is_page_template() – Can be used to determine if a page is using a specific template, for example: is_page_template('about-page.php')
    • is_category() – Returns true if page or post has the specified category, for example: is_category('news')
    • is_tag() – Returns true if a page or post has the specified tag
    • is_author() – Returns true if inside author’s archive page
    • is_search() – Returns true if the current page is a search results page
    • is_404() – Returns true if the current page does not exist
    • has_excerpt() – Returns true if the post or page has an excerpt

You must log in before being able to contribute a note or feedback.