WordPress.org

Ready to get started?Download WordPress

Codex

Function Reference/single cat title

Contents

Description

Displays or returns the page title if a category or tag archive is queried. Therefore, the function can be used only outside the loop.

Usage

 <?php single_cat_title$prefix$display ); ?> 

Default Usage

<?php single_cat_title( '', true ); ?>

Parameters

$prefix
(string) (optional) Text to output before the title.
Default: None

Note: The $prefix argument is currently ignored if the $display argument is false.
See http://core.trac.wordpress.org/ticket/16632

$display
(boolean) (optional) Should the page title be displayed (true) or returned for use in PHP (false).
Default: true

Return Values

(string/void) 
Page title if a category or tag archive is queried and the $display argument is set to false.

Examples

This example displays the text "Currently browsing " followed by the category title.

<p><?php single_cat_title('Currently browsing '); ?>.</p>
Currently browsing WordPress.


This example assigns the current category title to the variable $current_category for use in PHP.

<?php $current_category = single_cat_title("", false); ?>

Notes

Change Log

Since: Version 0.71

Source File

single_cat_title() is located in wp-includes/general-template.php.

Related

See also index of Function Reference and index of Template Tags.