is_singular( string|array $post_types = '' )

Is the query for an existing single post of any post type (post, attachment, page, custom post types)?


Description Description

If the $post_types parameter is specified, this function will additionally check if the query is for one of the Posts Types specified.


Parameters Parameters

$post_types

(string|array) (Optional) Post type or array of post types.

Default value: ''


Top ↑

Return Return

(bool) Whether the query is for an existing single post of any of the given post types.


Top ↑

Source Source

File: wp-includes/query.php

function is_singular( $post_types = '' ) {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_singular( $post_types );
}

Top ↑

Changelog Changelog

Changelog
Version Description
1.5.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note content
    Contributed by Codex

    Custom Post Types

    When any of the following return true: is_single(), is_page() or is_attachment().

    is_singular();
    

    True when viewing a post of the Custom Post Type book.

    is_singular( 'book' );
    

    True when viewing a post of the Custom Post Type newspaper or book.

    is_singular( array( 'newspaper', 'book' ) );
    

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