Skip to content
WordPress.org

Sardu

  • Themes
  • Plugins
  • News
  • About
  • Get WordPress
Get WordPress
WordPress.org

Plugin Directory

List Post Tags Shortcode

  • Submit a plugin
  • My favorites
  • Log in
  • Submit a plugin
  • My favorites
  • Log in

List Post Tags Shortcode

By Andre Moura
Download
  • Details
  • Reviews
  • Installation
  • Development
Support

Description

List Post Tags Shortcode provides a simple yet powerful way to display all post tags on your WordPress site using the [list_post_tags] shortcode.

Key Features:

  • Multiple Display Formats: Choose between unordered list (ul), inline, or comma-separated formats
  • Flexible Sorting: Sort tags by name, count, slug, or term group in ascending or descending order
  • Show Post Count: Optionally display the number of posts for each tag
  • Exclude Specific Tags: Exclude tags by ID from the display
  • Smart Caching: Built-in transient caching for improved performance
  • Customizable Classes: Add custom CSS classes for styling
  • Hide Empty Tags: Option to show or hide tags with no posts
  • Developer Friendly: Clean, well-documented code following WordPress coding standards

Basic Usage:

[list_post_tags]

Advanced Examples:

Display tags inline with post counts, sorted by popularity:
[list_post_tags format=”inline” show_count=”true” orderby=”count” order=”DESC”]

Display as unordered list without caching:
[list_post_tags format=”ul” cache=”0″ class=”my-custom-class”]

Exclude specific tags (IDs 1 and 5):
[list_post_tags exclude=”1,5″]

Perfect for:

  • Tag cloud pages
  • Sidebar widgets
  • Footer tag lists
  • Custom tag archives
  • Taxonomy overview pages

Privacy Policy

This plugin does not collect, store, or transmit any user data. All functionality is performed locally on your WordPress installation.

The admin review notice stores minimal preference data in the WordPress database:
* Activation date (stored in wp_options)
* User preference for review notice (stored in wp_usermeta, per administrator)

This data is used solely to manage the display of the review notice and can be deleted at any time.

Support

For support, feature requests, or bug reports, please visit:
* Plugin support forum: https://wordpress.org/support/plugin/list-post-tags-shortcode
* Plugin repository: https://github.com/andremoura/list-post-tags-shortcode (if applicable)

Credits

Developed by Andre Moura
Website: https://www.andremoura.com/

License

This plugin is licensed under the GPLv2 or later.

Good news, this plugin is free for everyone! Since it’s released under the GPL, you can use it free of charge on your personal or commercial site.

Installation

Automatic Installation:

  1. Log in to your WordPress admin panel
  2. Navigate to Plugins → Add New
  3. Search for “List Post Tags Shortcode”
  4. Click “Install Now” and then “Activate”

Manual Installation:

  1. Download the plugin ZIP file
  2. Log in to your WordPress admin panel
  3. Navigate to Plugins → Add New → Upload Plugin
  4. Choose the ZIP file and click “Install Now”
  5. Activate the plugin

Usage:

  1. Create a new page or edit an existing one
  2. Add the shortcode [list_post_tags] where you want the tag list to appear
  3. Customize with attributes as needed (see FAQ for all options)
  4. Publish or update the page

FAQ

What shortcode attributes are available?

  • format: Display format – 'ul' (default), 'inline', or 'comma'
  • orderby: Sort tags by – 'name' (default), 'count', 'slug', or 'term_group'
  • order: Sort direction – 'ASC' (default) or 'DESC'
  • show_count: Show post count – 'true' or 'false' (default)
  • exclude: Comma-separated tag IDs to exclude – e.g., '1,5,12'
  • hide_empty: Hide tags with no posts – 'true' (default) or 'false'
  • cache: Cache time in seconds – default 3600 (1 hour), set to 0 to disable
  • class: Additional CSS class for the container

How do I style the tag list?

The plugin outputs semantic HTML with CSS classes:

  • Container: .wlpt-tags
  • List items (ul format): <li> elements
  • Post count: .wlpt-count
  • Custom class: Use the class attribute

Example CSS:
.wlpt-tags { font-size: 14px; }
.wlpt-tags a { color: #0073aa; }
.wlpt-count { color: #999; }

Does this plugin use caching?

Yes! The plugin uses WordPress transients to cache the tag list, improving performance. The cache is automatically cleared when tags are created, edited, or deleted. Default cache time is 1 hour (3600 seconds), but you can adjust it with the cache attribute.

Can I exclude certain tags?

Yes, use the exclude attribute with comma-separated tag IDs:
[list_post_tags exclude=”1,5,12″]

To find tag IDs, go to Posts → Tags in your WordPress admin and hover over a tag name – the ID will appear in the URL.

Will this work with custom taxonomies?

Currently, the plugin only works with the default post_tag taxonomy. Support for custom taxonomies may be added in future versions.

Is the output XSS-safe?

Yes, all output is properly escaped using WordPress functions (esc_html, esc_url, esc_attr) to prevent XSS attacks.

Can I use this in a widget?

Yes! If your theme supports shortcodes in widgets, you can add the shortcode directly. Alternatively, use a text widget or the WordPress block editor.

How do I translate this plugin?

The plugin is translation-ready with the text domain list-post-tags-shortcode. Translation files should be placed in the /languages folder. You can use tools like Poedit or Loco Translate to create translations.

Reviews

Simple and Flexible Tag Display Made Easy

joanmichaels January 3, 2026
This plugin makes it incredibly simple to display post tags anywhere on my WordPress site using a clean shortcode. It offers flexible display formats and sorting options that fit perfectly with my theme. I love that it can show post counts and even exclude specific tags when needed. Performance is great thanks to smart caching and lightweight design. A must-have for anyone wanting elegant tag lists without coding.
Read all 1 review

Contributors & Developers

“List Post Tags Shortcode” is open source software. The following people have contributed to this plugin.

Contributors
  • Andre Moura

Translate “List Post Tags Shortcode” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0 (2025-12-22)

  • Initial release
  • Multiple display formats (ul, inline, comma)
  • Flexible sorting options
  • Optional post count display
  • Tag exclusion capability
  • Smart transient caching
  • Custom CSS class support
  • Hide empty tags option
  • Admin review notice for feedback
  • Full i18n support
  • Security: Proper output escaping and input sanitization
  • Performance: Transient caching with automatic invalidation

Meta

  • Version 1.0.1
  • Last updated 1 month ago
  • Active installations Fewer than 10
  • WordPress version 4.6 or higher
  • Tested up to 6.9.1
  • PHP version 7.4 or higher
  • Language
    English (US)
  • Tags
    post tagsshortcodetagstaxonomy
  • Advanced View

Ratings

5 out of 5 stars.
  • 1 5-star review 5 stars 1
  • 0 4-star reviews 4 stars 0
  • 0 3-star reviews 3 stars 0
  • 0 2-star reviews 2 stars 0
  • 0 1-star reviews 1 star 0

Add my review

See all reviews

Contributors

  • Andre Moura

Support

Got something to say? Need help?

View support forum

Donate

Would you like to support the advancement of this plugin?

Donate to this plugin

  • About
  • News
  • Hosting
  • Privacy
  • Showcase
  • Themes
  • Plugins
  • Patterns
  • Learn
  • Support
  • Developers
  • WordPress.tv ↗
  • Get Involved
  • Events
  • Donate ↗
  • Five for the Future
  • WordPress.com ↗
  • Matt ↗
  • bbPress ↗
  • BuddyPress ↗
WordPress.org
WordPress.org

Sardu

  • Visit our X (formerly Twitter) account
  • Visit our Bluesky account
  • Visit our Mastodon account
  • Visit our Threads account
  • Visit our Facebook page
  • Visit our Instagram account
  • Visit our LinkedIn account
  • Visit our TikTok account
  • Visit our YouTube channel
  • Visit our Tumblr account
Code is Poetry.