in_the_loop()

Determines whether the caller is in the Loop.


Description Description

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.


Return Return

(bool) True if caller is within loop, false if loop hasn't started or ended.


Top ↑

Source Source

File: wp-includes/query.php

function in_the_loop() {
	global $wp_query;
	return $wp_query->in_the_loop;
}

Top ↑

Changelog Changelog

Changelog
Version Description
2.0.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    Modify Single Post Entry Titles

    For use in your functions file, this code example enables you to modify the default output of your entry titles.

    function wpdocs_modify_single_post_entry_titles( $title ) {
    
    	if ( is_singular( 'post' ) && in_the_loop() ) {
    		/* Modify $title */
    	}
    
    	return $title;
    }
    add_filter( 'the_title', 'wpdocs_modify_single_post_entry_titles' );
    

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