Codex

Template Tags/the tags

Contents

Description

This template tag displays a link to the tag or tags a post belongs to. If no tags are associated with the current entry, the associated category is displayed instead. This tag should be used within The Loop.

Usage

 <?php the_tags$before$separator$after ); ?> 

Parameters

$before 
(string) Text to display before the actual tags are displayed. Defaults to Tags:
$separator 
(string) Text or character to display between each tag link. The default is a comma (,) between each tag.
$after 
(string) Text to display after the last tag. The default is to display nothing.

Examples

Displays a list of the tags with a linebreak after it.  <?php the_tags('Tags:'', ''<br />'); ?> 

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>
Tags: WordPress, Computers, Blogging

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: ',' > '); ?>
Social tagging: WordPress > Computers > Blogging


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: ',' &bull; ','<br />'); 
?>

Tagged with: WordPressComputersBlogging

A List Example

Displays a list of the tags as a real and simple (X)HTML list (<ul> / <ol> / <dl> ):

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

Integrating Categories and Tags

If you have existing posts associated with categories, and have started adding tags to posts as well, you may want to show an integrated list of categories and tags beneath each post. For example, assume you have pre-existing categories called Culture and Media, and have added tags to a post "Arts" and "Painting". To simplify the reader's experience and keep things uncluttered, you may want to display these as if they were all tags:

Tags: Culture, Media, Arts, Painting

This code will get you there, and will only render categories or tags if they're non-empty for the current post:


Tags:
<?php if (the_category(', '))  the_category(); ?>
<?php 
if (get_the_tags()) the_tags(); ?> 

Change Log

Since: 2.3.0

Related

the_tags, tag_description, single_tag_title, wp_tag_cloud, wp_generate_tag_cloud, get_tags, get_the_tags, get_the_tag_list, get_tag_link

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