the_tags( string $before = null, string $sep = ', ', string $after = '' )

Displays the tags for a post.

Contents

Parameters

$before string Optional
String to use before the tags. Defaults to 'Tags:'.

Default: null

$sep string Optional
String to use between the tags.

Default: ', '

$after string Optional
String to use after the tags.

Default: ''

Top ↑

More Information

This function returns an array of objects, one object for each tag assigned to the post. If this function is used in The Loop, then no ID need be passed.

Top ↑

Source

File: wp-includes/category-template.php. View all references 

function the_tags( $before = null, $sep = ', ', $after = '' ) {
	if ( null === $before ) {
		$before = __( 'Tags: ' );
	}

	$the_tags = get_the_tag_list( $before, $sep, $after );

	if ( ! is_wp_error( $the_tags ) ) {
		echo $the_tags;
	}
}

View on Trac View on GitHub

Top ↑

Top ↑

Changelog

Changelog
Version Description
2.3.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Default Usage
    The default usage lists tags with each tag (if more than one) separated by a comma (,) and preceded with the default text Tags: .

    <p><?php the_tags(); ?></p>

    Separated by Commas
    Displays a list of the tags with a line break after it.

    <?php the_tags( 'Tags: ', ', ', '<br />' ); ?>

    Separated by Arrow
    Displays links to tags with an arrow (>) separating the tags and preceded with the text Social tagging:

    <?php the_tags( 'Social tagging: ',' > ' ); ?>

    Separated by a Bullet
    Displays links to tags with a bullet (•) separating the tags and preceded with the text Tagged with: and followed by a line break.

    <?php the_tags( 'Tagged with: ', ' • ', '<br />' ); ?>

    A List Example
    Displays a list of the tags as an unordered list:

    <?php the_tags( '<ul><li>', '</li><li>', '</li></ul>' ); ?>

You must log in before being able to contribute a note or feedback.