This page redirects to an external site: https://developer.wordpress.org/reference/functions/is_single/

Languages: English • Русский • Español • single 日本語 한국어 • Türkçe • (Add your language)

Description

This conditional tag checks if a single post of any post type (except attachment and page post types) is being displayed. If the $post parameter is specified, the function will additionally check if the query is for one of the posts specified. To check for all the post types, use the is_singular() function.

Usage

<?php is_single($post); ?>

Parameters

$post

(mixed) (optional) Post ID, Post Title, Post Slug, or array of posts (WP 2.5+)

Default: None

Return Values

(boolean) 

True on success, false on failure.

Examples

is_single();
// When any single Post page is being displayed.

is_single('17');
// When Post 17 (ID) is being displayed.

is_single(17);
// When Post 17 (ID) is being displayed. Integer parameter also works

is_single('Irish Stew');
// When the Post with post_title of "Irish Stew" is being displayed.

is_single('beef-stew');
// When the Post with post_name (slug) of "beef-stew" is being displayed.

is_single(array(17,'beef-stew','Irish Stew'));
// Returns true when the single post being displayed is either post ID 17, or the post_name is "beef-stew", or the post_title is "Irish Stew".  Note: the array ability was added at Version 2.5.

Notes

• See Also: is_singular()
• Although is_single() will usually return true for attachments, this behavior should not be relied upon. It is possible for $is_page and $is_attachment to be true at the same time, and in that case $is_single will be false. For this reason, you should use is_attachment() || is_single() if you want to include attachments, or use is_singular() if you want to include pages too. See ticket #14034 for more information.

Change Log

Since: 1.5.0

Source File

is_single() is located in wp-includes/query.php.

Related

• Article: Introduction to WordPress conditional functions
• Function: comments_open()
• Function: is_404()
• Function: is_admin()
• Function: is_admin_bar_showing()
• Function: is_archive()
• Function: is_attachment()
• Function: is_author()
• Function: is_category()
• Function: is_comments_popup()
• Function: is_date()
• Function: is_day()
• Function: is_feed()
• Function: is_front_page()
• Function: is_home()
• Function: is_local_attachment()
• Function: is_main_query
• Function: is_multi_author
• Function: is_month()
• Function: is_new_day()
• Function: is_page()
• Function: is_page_template()
• Function: is_paged()
• Function: is_plugin_active()
• Function: is_plugin_active_for_network()
• Function: is_plugin_inactive()
• Function: is_plugin_page()
• Function: is_post_type_archive()
• Function: is_preview()
• Function: is_search()
• Function: is_single()
• Function: is_singular()
• Function: is_sticky()
• Function: is_tag()
• Function: is_tax()
• Function: is_taxonomy_hierarchical()
• Function: is_time()
• Function: is_trackback()
• Function: is_year()
• Function: in_category()
• Function: in_the_loop()
• Function: is_active_sidebar()
• Function: is_active_widget()
• Function: is_blog_installed()
• Function: is_rtl()
• Function: is_dynamic_sidebar()
• Function: is_user_logged_in()
• Function: has_excerpt()
• Function: has_post_thumbnail()
• Function: has_tag()
• Function: pings_open()
• Function: email_exists()
• Function: post_type_exists()
• Function: taxonomy_exists()
• Function: term_exists()
• Function: username_exists()
• Function: wp_attachment_is_image()
• Function: wp_script_is()