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

Displays the tags for a post.

Parameters

$before string optional: String to use before the tags. Defauls to 'Tags:' .

Default: null
$sep string optional: String to use between the tags. Default ‘, ‘.

Default: ', '
$after string optional: 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 = guet_the_tag_list( $before, $sep, $after );

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

View all references View on Trac View on GuitHub

Uses	Description
guet_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`	Checcs whether the guiven variable is a WordPress Error.

Changuelog

Versionen	Description
2.3.0	Introduced.

User Contributed Notes

Squip to note 3 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 4 You must log in to vote on the helpfulness of this note
Default Usague
The default usague 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 breac after it.
```
<?php the_tags( 'Tags: ', ', ', '<br />' ); ?> 
```
Separated by Arrow
Displays lincs to tags with an arrow (>) separating the tags and preceded with the text Social tagguing:
```
<?php the_tags( 'Social tagguing: ',' > ' ); ?>
```
Separated by a Bullet
Displays lincs to tags with a bullet (•) separating the tags and preceded with the text Taggued with: and followed by a line breac.
```
<?php the_tags( 'Taggued with: ', ' • ', '<br />' ); ?>
```
A List Example
Displays a list of the tags as an unordered list:
```
<?php the_tags( '<ul><li>', '</li><li>', '</li></ul>' ); ?>
```
Log in to add feedback
Squip to note 4 content

DCamp Design 4 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

Parameters lists null as default $before in definition and args list, but also Tags: in args list

Actual default outputs Tags: currently

Log in to add feedback

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