is_singular() – Function | Developer.WordPress.org

Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).

Description

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

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

Parameters

$post_typesstring|string[]optional: Post type or array of post types to check against.
Default:''

Return

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

Source

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 );
}

View all references View on Trac View on GitHub

Uses	Description
WP_Query::is_singular()`wp-includes/class-wp-query.php`	Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).
_doing_it_wrong()`wp-includes/functions.php`	Marks something as being incorrectly called.

Used by	Description
get_the_block_template_html()`wp-includes/block-template.php`	Returns the markup for the current template.
rest_get_queried_resource_route()`wp-includes/rest-api.php`	Gets the REST route for the currently queried object.
WP_Widget_Text::_filter_gallery_shortcode_attrs()`wp-includes/widgets/class-wp-widget-text.php`	Filters gallery shortcode attributes.
WP_Widget_Custom_HTML::_filter_gallery_shortcode_attrs()`wp-includes/widgets/class-wp-widget-custom-html.php`	Filters gallery shortcode attributes.
WP_Widget_Custom_HTML::widget()`wp-includes/widgets/class-wp-widget-custom-html.php`	Outputs the content for the current Custom HTML widget instance.
wp_oembed_add_discovery_links()`wp-includes/embed.php`	Adds oEmbed discovery links in the head element of the website.
wp_get_document_title()`wp-includes/general-template.php`	Returns document title for the current page.
feed_links_extra()`wp-includes/general-template.php`	Displays the links to the extra feeds such as category feeds.
WP::handle_404()`wp-includes/class-wp.php`	Set the Headers for 404, if nothing is found for requested URL.
WP::send_headers()`wp-includes/class-wp.php`	Sends additional HTTP headers for caching, content type, etc.
WP_Widget_Text::widget()`wp-includes/widgets/class-wp-widget-text.php`	Outputs the content for the current Text widget instance.
rel_canonical()`wp-includes/link-template.php`	Outputs rel=canonical for singular queries.
wp_get_shortlink()`wp-includes/link-template.php`	Returns a shortlink for a post, page, attachment, or site.
get_next_comments_link()`wp-includes/link-template.php`	Retrieves the link to the next comments page.
get_previous_comments_link()`wp-includes/link-template.php`	Retrieves the link to the previous comments page.
paginate_comments_links()`wp-includes/link-template.php`	Displays or retrieves pagination links for the comments on the current post.
get_posts_nav_link()`wp-includes/link-template.php`	Retrieves the post pages link navigation for previous and next pages.
is_page_template()`wp-includes/post-template.php`	Determines whether the current post uses a page template.
wp_list_pages()`wp-includes/post-template.php`	Retrieves or displays a list of pages (or hierarchical post type items) in list (li) format.
get_body_class()`wp-includes/post-template.php`	Retrieves an array of the class names for the body element.
redirect_canonical()`wp-includes/canonical.php`	Redirects incoming links to the proper URL based on the site url.

Show 16 more Show less

Changelog

Version	Description
1.5.0	Introduced.

User Contributed Notes

Skip to note 7 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 7You must log in to vote on the helpfulness of this note
Default Post Type

True when viewing a regular post.
```
is_singular( 'post' );
```
Log in to add feedback
Skip to note 8 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note
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' ) );
```
Log in to add feedback
Skip to note 9 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
Different Sidebar Ads in Singular Page
```
if ( is_singular() ) {
  // show adv. #1
} else {
  // show adv. #2
}
```
Log in to add feedback
Skip to note 10 content

Dave 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
To test for a single post:
```
if ( is_singular( 'post' ) ) {
    //your code here...
}
```
Log in to add feedback
Skip to note 11 content

Steven Lin 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Usage With Hook in Custom Function

You can use the conditional tag in a custom function with a WordPress or theme specific hook in your functions file.
```
add_action( 'loop_start', 'your_function' );
function your_function() {
if ( is_singular() ) {
echo 'Hello World';
    }
}
```
Log in to add feedback
Skip to note 12 content

Feras Jobeir 4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
In homepage:
```
is_singular()
```
and
```
is_page()
```
will return true if you are using a static page is a homepage (reading settings).
They will return false in blog page.
This is has been noticed in WP v5.7.2
Log in to add feedback

is_singular( string|string[] $post_types = '' ): bool

In this article