Limited Time Offer

Save 25% on our plugins with this coupon:

LOVEWORDPRESS

Buy Now
Skip to content
TaxoPress
  • TaxoPress
  • Tag Groups
  • Docs
  • Blog
  • Support
  • Login
Buy Now
TaxoPress

Tag Groups: Getting Started

  • Introduction to Tag Groups
  • Installation of Tag Groups Free
  • First Steps With Tag Groups
  • Tag Groups Free vs Pro

How to Use Groups for Tags

  • Creating and Editing Groups
  • Filter Tag Groups on the Tags Screen
  • Bulk Actions for Groups on the Tags Screen
  • Organizing Groups with a Parent Level
  • Using the Tag Groups Metabox on the Post Edit Screen

Display Options for Tags

  • How To Use Gutenberg Blocks With Tag Groups
  • How to Use Shortcodes With Tag Groups
  • Tag Groups Themes: Design and Colors
  • How to Design Tag Colors in Tag Groups
  • How to Modify a Theme in Tag Groups
  • Create Your Own Accordion and Tab Themes

Tag List

  • Tag List – Overview
  • Tag List – Gutenberg Block
  • Tag List – Shortcode Parameters

Tabbed Tag Cloud

  • Tabbed Tag Cloud – Overview
  • Tabbed Tag Cloud – Gutenberg Block
  • Tabbed Tag Cloud – Shortcode Parameters
  • Tabbed Tag Cloud – Themes

Alphabetical Tag Index

  • Alphabetical Tag Index – Overview
  • Alphabetical Tag Index – Gutenberg Block
  • Alphabetical Tag Index – Shortcode Parameters

Alphabetical Tag Cloud

  • Alphabetical Tag Cloud – Overview
  • Alphabetical Tag Cloud – Gutenberg Block
  • Alphabetical Tag Cloud – Shortcode Parameters
  • Alphabetical Tag Cloud – Themes

Accordion Tag Cloud

  • Accordion Tag Cloud – Overview
  • Accordion Tag Cloud – Gutenberg Block
  • Accordion Tag Cloud – Shortcode Parameters
  • Accordion Tag Cloud – Themes

Tag Groups Info

  • Tag Groups Info – Overview
  • Tag Groups Info – Shortcode Parameters

Show Tags Under Posts (Pro)

  • How to Show Tag Groups on Posts
  • Change the Icons on Tags Under Posts

Shuffle Box (Pro)

  • Shuffle Box – Overview
  • Shuffle Box – Gutenberg Block
  • Shuffle Box – Shortcode Parameters
  • Create a Custom Color Scheme for Shuffle Box
  • Hide the “not assigned” button in the Shuffle Box

Simple Tag Cloud (Pro)

  • Simple Tag Cloud – Overview
  • Simple Tag Cloud – Gutenberg Block
  • Simple Tag Cloud – Shortcode Parameters

Table Tag Cloud (Pro)

  • Table Tag Cloud – Overview
  • Table Tag Cloud – Gutenberg Block
  • Table Tag Cloud – Shortcode Parameters

Post List (Pro)

  • Post List – Overview
  • Post List – Gutenberg Block
  • Post List – Shortcode Parameters

Dynamic Post Filter (Pro)

  • Dynamic Post Filter – Overview
  • Dynamic Post Filter – Gutenberg Block
  • Dynamic Post Filter – Shortcode Parameters
  • I Don’t See Posts In the Dynamic Post Filter

Tag Cloud Search (Pro)

  • Tag Cloud Search – Overview
  • Tag Cloud Search – Gutenberg Block
  • Tag Cloud Search – Shortcode Parameters

Tag Groups Menu (Pro)

  • Tag Groups Menu – Overview
  • Tag Groups Menu – Shortcode Parameters

Toggle Post Filter (Pro)

  • Toggle Post Filter – Overview
  • Toggle Post Filter – Shortcodes Overview
  • Toggle Post Filter, Posts – Gutenberg Block
  • Toggle Post Filter, Posts – Shortcode Parameters
  • Toggle Post Filter, Menu – Gutenberg Blocks
  • Toggle Post Filter, Menu – Shortcode Parameters
  • Toggle Post Filter, Text Search – Gutenberg Block
  • Toggle Post Filter, Text Search – Shortcode Parameters
  • Toggle Post Filter, Slider Button – Gutenberg Block
  • Toggle Post Filter, Slider Button – Shortcode Parameters
  • Toggle Post Filter, Order Menu, Gutenberg Block
  • Toggle Post Filter, Order Menu – Shortcode Parameters
  • Toggle Post Filter, Reset Button – Shortcode Parameters

Tag Groups: Settings

  • The Home Screen in Tag Groups
  • Taxonomies and the Tag Groups Plugin
  • Front End Settings
  • Back End Settings in Tag Groups
  • Tools
  • Troubleshooting
  • Control Who Can Edit the Tag Groups

Tag Groups: Frequently Asked Questions

  • Glossary of Useful Words for Tag Groups
  • How to Display Tags in a Custom Sort Order?
  • Can I Use Tag Groups Multiple Times on The Same Page?
  • Which Tag Groups Feature Do I Need?
  • Can I Use the Tag Groups Plugin with Pages?
  • Can I Use the Tag Groups plugin with Categories?
  • How to Make the Alphabetical Tag Index or the Tag List Responsive?
  • Can I Use Tag Groups with Custom Taxonomies?
  • What are the Minimum System Requirements to Install Tag Groups?
  • “The free Tag Groups plugin cannot be active together with Tag Groups Pro.”

Tag Groups: Troubleshooting

  • Tags Not Visible in the WordPress Admin After Installing Tag Groups
  • Debugging a WordPress Ajax Error
  • Shortcodes Don’t Work Inside Widgets
  • I Cannot Use Multiple Tag Clouds on the Same Page
  • I Don’t See All Tags in the Tag Meta Box
  • How To Use The Debug Log in Tag Groups
  • Instead of the Tag Cloud There’s An Empty Space
  • Can Not Save HTML in the Tag Description
  • Tag Cloud: When I Click on a Tag, the Posts Don’t Differentiate by Groups
  • “Error loading block: The response is not a valid JSON response.”

Questions About Post Filters

  • Using the Post Filter on Frontend URLs
  • How to Choose a Custom Order in the Post Filter
  • How to Change the Length of the Post Excerpts
  • Change the Size of the First Posts in the Masonry Layout
  • Limit the Size of the Menu in the Dynamic Post Filter

Tag Groups: Maintenance and Optimization

  • How to Reduce the Number of Loaded Scripts for Better Speed and SEO
  • How to Improve the Performance of the Toggle Post Filter/Dynamic Post Filter
  • Running Maintenance
  • How to Improve the Speed of Tag Groups
  • Migrating your Tags and Posts to Tag Groups

Tag Groups: For Developers

  • Tag Groups and the REST API
  • Filters and Actions in Tag Groups
  • Modifying the Post Query
  • Modifying the Term Query
  • Using Tag Groups in Theme Files
  • Useful Constants for the Tag Groups Plugin

Tag Groups Integrations

  • Integration with WooCommerce Attributes
  • Does Tag Groups Work with the Polylang Plugin?
  • Translating Tag Group Names With WPML
  • Home
  • TaxoPress Documentation
  • The Tag Groups Plugin
  • Tag List
  • Tag List – Shortcode Parameters

Tag List – Shortcode Parameters

Table of Contents
  • Shortcode
  • Example
  • Data Types
  • Parameters
    • add_premium_filter
    • amount
    • append
    • assigned_class
    • column_count
    • column_gap
    • custom_title
    • custom_title_zero
    • custom_title_plural
    • div_class
    • div_id
    • exclude_terms
    • group_in_class
    • groups_post_id
    • h_level
    • header_class
    • hide_empty_content
    • hide_empty
    • threshold
    • include
    • exclude
    • include_terms
    • keep_together
    • largest
    • link_target
    • link_append
    • not_assigned_name
    • order
    • orderby
    • prepend
    • show_not_assigned
    • show_all_groups
    • show_tag_count
    • smallest
    • tags_div_class
    • tags_post_id
    • taxonomy

This guide shows you how to use and customize the shortcode for the Tag List feature in the Tag Groups plugin.


Shortcode #

[tag_groups_tag_list]

Example #

[tag_groups_tag_list append="{count}"]

Data Types #

  • string: A text. For identifiers that won’t be visible to visitors you often have to replace spaces with _ or -. If the string contains spaces, you need to wrap it in quotes.
  • integer: A number without decimal places.
  • 0 or 1: 0 turns the feature off and 1 on.

Parameters #

This overview assumes that you know how to use shortcodes. Shortcodes are the traditional WordPress way how to add features into posts, pages and widgets.

add_premium_filter #

Modifies the URL – for the case that you use the same tag in various groups.

DefaultPossible ValuesExample
0 (false)0 or 1add_premium_filter=1

amount #

the maximum number of tags per group to display

DefaultPossible ValuesExample
0 (no limit)integeramount=10

append #

adds something behind the tag name; placeholder: {count} for post count

DefaultPossible ValuesExample
emptystringappend=” ({count})”

assigned_class #

adds class name to tags that shows whether the tag is assigned or not; assigned tags have “_1” appended, unassigned “_0” to the class name

DefaultPossible ValuesExample
emptystringassigned_class="colored-tags"

column_count #

number of columns

DefaultPossible ValuesExample
2integercolumn_count=3

column_gap #

width of the gap between columns

DefaultPossible ValuesExample
10pxstringcolumn_gap=20px

custom_title #

tooltip when hovering the mouse over a tag; placeholders: {count} for post count, {description} for tag description, {name} for tag name

If you also use custom_title_plural then the text of custom_title will be used for a post count of 1 and you can use here the singular form

DefaultPossible ValuesExample
depends on show_tag_countstringcustom_title="One post uses {name}"

custom_title_zero #

tooltip when hovering the mouse over a tag; placeholders: {count} for post count, {description} for tag description, {name} for tag name

This text will be used for tags that have a post count of 0 (i.e. they are not used with any published post).

DefaultPossible ValuesExample
not usedstringcustom_title_zero="No post uses {name}"

custom_title_plural #

tooltip when hovering the mouse over a tag; placeholders: {count} for post count, {description} for tag description, {name} for tag name

This text will be used for tags that have a post count of >1. You can use here plural forms.

DefaultPossible ValuesExample
not usedstringcustom_title_plural="{count} posts use {name}"

div_class #

class of the enclosing div for own styling

DefaultPossible ValuesExample
tag-groups-tag-liststringdiv_class="my-class"

div_id #

ID of the enclosing div

DefaultPossible ValuesExample
randomstring (must be unique on the page)div_id="my-id"

exclude_terms #

a list of tags that should not appear

DefaultPossible ValuesExample
emptycomma-separated list of tag IDsexclude_terms=

group_in_class #

whether to add information about the groups into the class attribute; tg_tag_group_id_ + ID and tg_tag_group_label_ + tag name (spaces replaced with dashes)

DefaultPossible ValuesExample
0 (off)0 or 1group_in_class=1

groups_post_id #

ID of a post that the tags should be take from. 0 tries to get current post.

DefaultPossible ValuesExample
-1 (off)integergroups_post_id=5634

h_level #

<h3>/h3>, <h4></h4>, … of the headings with the group names

DefaultPossible ValuesExample
3integerh_level=2

header_class #

class for the headers

DefaultPossible ValuesExample
emptystringheader_class="my-class"

hide_empty_content #

hide empty groups

DefaultPossible ValuesExample
0 (off)0 or 1hide_empty_content=1

hide_empty #

hide tags with post count zero

DefaultPossible ValuesExample
10 or 1hide_empty=0

threshold #

Set a minimum count of published posts that use a tag for this tag to appear. Posts are counted across all groups. Please also pay attention to the value of hide_empty.

DefaultPossible ValuesExample
0integerhide_empty=0

include #

groups to include

DefaultPossible ValuesExample
allcomma-separated list of group IDsinclude=2,3,5

exclude #

groups to exclude

DefaultPossible ValuesExample
nonecomma-separated list of group IDsexclude=2,3,5

include_terms #

tags to include (see also “hide_empty”)

DefaultPossible ValuesExample
allcomma-separated list of tag IDsinclude_terms=12,34,255

keep_together #

whether to keep headings and tag block together; otherwise tags lists may continue in a new column

DefaultPossible ValuesExample
1 (on)0 or 1keep_together=1

largest #

max. font size in pt

DefaultPossible ValuesExample
12integerlargest=32

link_target #

target attribute of the tag link (_blank, _top, _self, …)

DefaultPossible ValuesExample
emptystringlink_target="_top"

link_append #

append query to the link

DefaultPossible ValuesExample
emptystringlink_append=“source=cloud”

not_assigned_name #

lets you choose a custom group name for not-assigned tags

DefaultPossible ValuesExample
not assignedstringnot_assigned_name="unsorted tags"

order #

ascending or descending order; use with orderby

DefaultPossible ValuesExample
ascstring (asc or desc)order=desc

orderby #

by what to order the tags

use together with order

DefaultPossible ValuesExample
namestringorderby=natural

prepend #

prepend to the tag; placeholder: {count} for post count

DefaultPossible ValuesExample
emptystringprepend="#"

show_not_assigned #

whether to show tags that are not assigned to any group

DefaultPossible ValuesExample
00 or 1show_not_assigned=1

show_all_groups #

whether to show also empty groups

DefaultPossible ValuesExample
0 (off)0 or 1show_all_groups=1

show_tag_count #

show the post count in the title (deprecated option, better use custom_title

DefaultPossible ValuesExample
1 (on)0 or 1show_tag_count=0

smallest #

min. font size in pt

DefaultPossible ValuesExample
12integersmallest=14

tags_div_class #

class name for the divs around tags

DefaultPossible ValuesExample
emptystringtags_div_class="my-class"

tags_post_id #

Use post ID or zero for current post.

DefaultPossible ValuesExample
-1 (not used)integertags_post_id=0

taxonomy #

taxonomies (tag types) to use

DefaultPossible ValuesExample
all selected in the settingscomma-separated list of taxonomy names/slugstaxonomy=product_tag
Tag List – Gutenberg Block
Table of Contents
  • Shortcode
  • Example
  • Data Types
  • Parameters
    • add_premium_filter
    • amount
    • append
    • assigned_class
    • column_count
    • column_gap
    • custom_title
    • custom_title_zero
    • custom_title_plural
    • div_class
    • div_id
    • exclude_terms
    • group_in_class
    • groups_post_id
    • h_level
    • header_class
    • hide_empty_content
    • hide_empty
    • threshold
    • include
    • exclude
    • include_terms
    • keep_together
    • largest
    • link_target
    • link_append
    • not_assigned_name
    • order
    • orderby
    • prepend
    • show_not_assigned
    • show_all_groups
    • show_tag_count
    • smallest
    • tags_div_class
    • tags_post_id
    • taxonomy

Recent Posts

  • How to Find the IDs of WordPress Tags, Posts or Categories May 24, 2023
  • How to Change the Design of Accordions and Tabbed Tag Clouds May 16, 2023
  • How to Add Custom Designs to Terms in Tag Groups May 15, 2023
  • Find The Most Used Tags On Your WordPress Site May 14, 2023
  • What is a Tag Slug in WordPress? May 11, 2023

Testimonials

I’ve used this for a long time and it is really a great plugin. If you need terms tagging capabilities, this is great!

woodb01

I had a support issue and the response was same day. I find the plugin extremely fast and easy to implement.

stevenmayjr

Important Links

  • TaxoPress Demos
  • Frequently Asked Questions
  • About the TaxoPress Team
  • Terms of Service
  • TaxoPress Affiliates
  • Logo and Brand Materials

Our Projects

  • PublishPress
  • MetaSlider
  • KinshiPress
  • Ramble Ventures
  • Logtivity

© 2023 TaxoPress

Facebook Twitter
Scroll to top
  • TaxoPress
  • Tag Groups
  • Docs
  • Blog
  • Support
Search