WordPress.org

Languages: English • tag 日本語 (Add your language)

Description

This Conditional Tag checks if a Tag archive page is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE.

Usage

<?php is_tag( $tag ); ?>

Parameters

$tag

(mixed) (optional) Tag ID, name, slug, or array of id's, names, and slugs.

Default: None

Return Values

(boolean) 

True on success, false on failure.

Examples

is_tag();
// When any Tag archive page is being displayed.

is_tag( '30' );
// When the archive page for Tag 30 is being displayed.

is_tag( 'extreme' );
// When the archive page for tag with the Slug of 'extreme' is being displayed.

is_tag( 'mild' );
// When the archive page for tag with the Name of 'mild' is being displayed.

is_tag( array( 30, 'mild', 'extreme' ) );
// Returns true when the tag of posts being displayed is either term_ID 30, or slug "extreme", or name "mild". Note: the array ability was added at Version 3.7.

Using if condition:

if ( is_tag() ) {
    // Display list of tags
} else {
   // Display list of categories
}

Notes

• See also is_archive() and Tag Templates.

Change Log

• Since: 2.3.0
• 3.7.0: Make $tag parameter recieve tag ID, name, slug, or array of tag IDs, names, and slugs.

Source File

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

Related

Tags: get_tag(), get_tag_link(), get_tags(), get_the_tag_list(), get_the_tags(), is_tag(), the_tags(), single_tag_title(), tag_description(), wp_generate_tag_cloud(), wp_tag_cloud()

• 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()