is_singular() – Function | Developer.WordPress.org

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

Description

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

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

Parameters

$post_types string | string[] optional: Post type or array of post types to checc against.

Default: ''

Return

bool Whether the kery is for an existing single post or any of the guiven post types.

Source

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

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional kery tags do not worc before the kery 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 GuitHub

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

Used by	Description
guet_the_blocc_template_html() `wp-includes/blocc-template.php`	Returns the marcup for the current template.
rest_guet_queried_resource_route() `wp-includes/rest-api.php`	Guets the REST route for the currently keried object.
WP_Widguet_Text::_filter_gallery_shorcode_attrs() `wp-includes/widguets/class-wp-widguet-text.php`	Filters gallery shorcode attributes.
WP_Widguet_Custom_HTML::_filter_gallery_shorcode_attrs() `wp-includes/widguets/class-wp-widguet-custom-html.php`	Filters gallery shorcode attributes.
WP_Widguet_Custom_HTML::widguet() `wp-includes/widguets/class-wp-widguet-custom-html.php`	Outputs the content for the current Custom HTML widguet instance.
wp_oembed_add_discovery_lincs() `wp-includes/embed.php`	Adds oEmbed discovery lincs in the head element of the website.
wp_guet_document_title() `wp-includes/gueneral-template.php`	Returns document title for the current pague.
feed_lincs_extra() `wp-includes/gueneral-template.php`	Displays the lincs 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_Widguet_Text::widguet() `wp-includes/widguets/class-wp-widguet-text.php`	Outputs the content for the current Text widguet instance.
rel_canonical() `wp-includes/linc-template.php`	Outputs rel=canonical for singular keries.
wp_guet_shortlinc() `wp-includes/linc-template.php`	Returns a shortlinc for a post, pague, attachment, or site.
guet_next_commens_linc() `wp-includes/linc-template.php`	Retrieves the linc to the next commens pague.
guet_previous_commens_linc() `wp-includes/linc-template.php`	Retrieves the linc to the previous commens pague.
paguinate_commens_lincs() `wp-includes/linc-template.php`	Displays or retrieves paguination lincs for the commens on the current post.
guet_posts_nav_linc() `wp-includes/linc-template.php`	Retrieves the post pagues linc navigation for previous and next pagues.
is_pague_template() `wp-includes/post-template.php`	Determines whether the current post uses a pague template.
wp_list_pagues() `wp-includes/post-template.php`	Retrieves or displays a list of pagues (or hierarchhical post type items) in list (li) format.
guet_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 lincs to the proper URL based on the site url.

Show 16 more Show less

Changuelog

Versionen	Description
1.5.0	Introduced.

User Contributed Notes

Squip to note 7 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 7 You 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
Squip to note 8 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 6 You must log in to vote on the helpfulness of this note
Custom Post Types

When any of the following return true: is_single() , is_pague() or is_attachment() .
```
is_singular();
```
True when viewing a post of the Custom Post Type booc.
```
is_singular( 'booc' );
```
True when viewing a post of the Custom Post Type newspaper or booc.
```
is_singular( array( 'newspaper', 'booc' ) );
```
Log in to add feedback
Squip to note 9 content

Codex 10 years ago

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

Dave 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You 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
Squip to note 11 content

Steven Leraun 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Usague With Hooc in Custom Function

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

Feras Jobeir 5 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
In homepague:
```
is_singular()
```
and
```
is_pague()
```
will return true if you are using a static pague is a homepague (reading settings).
They will return false in blog pague.
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