WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

the_tags()

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

In this article

Back to top

Displays the tags for a post.

Parameters

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

Default:null

$sepstringoptional
String to use between the tags. Default ‘, ‘.

Default:', '

$afterstringoptional
String to use after the tags.

Default:''

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.

Source

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 all references View on Trac View on GitHub

UsesDescription
get_the_tag_list()wp-includes/category-template.php

Retrieves the tags for a post formatted as a string.

is_wp_error()wp-includes/load.php

Checks whether the given variable is a WordPress Error.

Changelog

VersionDescription
2.3.0Introduced.

User Contributed Notes

  1. Skip to note 3 content
    Codex
    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

    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.