Tag List – Shortcode Parameters

Note: This shortcode is also available as Gutenberg block. You can configure the block without using any code or parameters. Read more about the block options.

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.

amount

the maximum number of tags per group to display

Default	Possible Values	Example
0 (no limit)	integer	amount=10

append

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

Default	Possible Values	Example
empty	string	append=” ({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

Default	Possible Values	Example
empty	string	assigned_class="colored-tags"

column_count

number of columns; for responsive design follow these instructions

Default	Possible Values	Example
2	integer	column_count=3

column_gap

width of the gap between columns

Default	Possible Values	Example
10px	string	column_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

Default	Possible Values	Example
depends on show_tag_count	string	custom_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).

Default	Possible Values	Example
not used	string	custom_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.

Default	Possible Values	Example
not used	string	custom_title_plural="{count} posts use {name}"

div_class

class of the enclosing div for own styling

Default	Possible Values	Example
tag-groups-tag-list	string	div_class="my-class"

div_id

ID of the enclosing div

Default	Possible Values	Example
random	string (must be unique on the page)	div_id="my-id"

exclude_terms

a list of tags that should not appear

Default	Possible Values	Example
empty	comma-separated list of tag IDs	exclude_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)

Default	Possible Values	Example
0 (off)	0 or 1	group_in_class=1

groups_post_id

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

Default	Possible Values	Example
-1 (off)	integer	groups_post_id=5634

h_level

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

Default	Possible Values	Example
3	integer	h_level=2

header_class

class for the headers

Default	Possible Values	Example
empty	string	header_class="my-class"

hide_empty_content

hide empty groups

Default	Possible Values	Example
0 (off)	0 or 1	hide_empty_content=1

hide_empty

hide tags with post count zero

Default	Possible Values	Example
1	0 or 1	hide_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.

Default	Possible Values	Example
0	integer	threshold=2

include

groups to include

Default	Possible Values	Example
all	comma-separated list of group IDs	include=2,3,5

exclude

groups to exclude

Default	Possible Values	Example
none	comma-separated list of group IDs	exclude=2,3,5

include_terms

tags to include (see also “hide_empty”)

Default	Possible Values	Example
all	comma-separated list of tag IDs	include_terms=12,34,255

keep_together

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

Default	Possible Values	Example
1 (on)	0 or 1	keep_together=1

largest

max. font size in pt

Default	Possible Values	Example
12	integer	largest=32

link_target

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

Default	Possible Values	Example
empty	string	link_target="_top"

link_append

append query to the link

Default	Possible Values	Example
empty	string	link_append=“source=cloud”

not_assigned_name

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

Default	Possible Values	Example
not assigned	string	not_assigned_name="unsorted tags"

order

ascending or descending order; use with orderby

Default	Possible Values	Example
asc	string (asc or desc)	order=desc

orderby

by what to order the tags:
‘name’, ‘natural’, ‘slug’, ‘term_group’, ‘term_id’, ‘id’, ‘description’, ‘count’;

A custom sort order is available with a 3rd-party plugin.

use together with order

Default	Possible Values	Example
name	string	orderby=natural

prepend

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

Default	Possible Values	Example
empty	string	prepend="#"

show_not_assigned

whether to show tags that are not assigned to any group

Default	Possible Values	Example
0	0 or 1	show_not_assigned=1

show_all_groups

whether to show also empty groups

Default	Possible Values	Example
0 (off)	0 or 1	show_all_groups=1

show_tag_count

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

Default	Possible Values	Example
1 (on)	0 or 1	show_tag_count=0

smallest

min. font size in pt

Default	Possible Values	Example
12	integer	smallest=14

tags_div_class

class name for the divs around tags

Default	Possible Values	Example
empty	string	tags_div_class="my-class"

tags_post_id

Use post ID or zero for current post.

Default	Possible Values	Example
-1 (not used)	integer	tags_post_id=0

taxonomy

taxonomies (tag types) to use

Default	Possible Values	Example
all selected in the settings	comma-separated list of taxonomy names/slugs	taxonomy=product_tag