Tag List – Gutenberg Block

With the Tag List feature, terms are displayed in columns under their group names. You can choose which groups to show and you can customize how the tags layout.

This guide will show you how to use the Gutenberg block that is available with the Tag List feature.

Tag List - Gutenberg Block

Tags and Taxonomies #

Include taxonomies #

Select the “tag type”. By default we use all that are enabled in the Tag Groups settings.

Smallest font size #

Font size of the tags with the smallest post count.

Largest font size #

Font size of the tags with the largest post count.

Tags per group #

Maximum number of tags per group.

Order tags by #

Field that we should compare when ordering the tag. If you choose “natural sorting” with “Tags per group” then the number will be determined after sorting by name (not natural sorting).

Note on random order: The order only changes when all object and page caches refresh.

Sort order #

ascending or descending order

Hide unused tags #

Hide tags with a post count of zero.

Minimum post count for tags to appear #

Set a minimum count of published posts that use a tag for this tag to appear. Posts are counted across all groups.

Prepend #

Character or text to place before each tag. You can use the placeholder {count} to insert the post count.

Append #

Character or text to place after each tag. You can use the placeholder {count} to insert the post count.

Show post count in the tooltip #

Show the number of posts that use that tag when hovering the mouse over the tag.

Custom title for post count = 0 #

The custom title can be configured separately for tags that have a post count of zero. You can use the placeholders {count} to insert the post count, {description} for the tag description and {name} for the tag name.

Custom title for post count =1 #

Tooltip text when hovering the mouse over the tag. You can use the placeholders {count} to insert the post count, {description} for the tag description and {name} for the tag name.

Custom title for post count >1 #

The custom title can be configured separately for tags that have a post count > 1 so that you can use here plural in your text. You can use the placeholders {count} to insert the post count, {description} for the tag description and {name} for the tag name.

Set the “target” attribute for the links of the tags. Possible values are:

  • _blank: open in a new tab/window
  • _self: open in the same frame
  • _parent: open in the parent frame
  • _top: open in the full tab/window of this frame

In the shortcode you can also set the name of a frame.

Append something to each tag’s link, for example a URL query.

Add filter to tags for multiple groups #

When you use the premium plugin, additional query parameters in the links make sure that we can distinguish between the same tag that is used in different groups. If the resulting posts are not complete and troubleshooting doesn’t help, you can disable it here.

Use tags of the following post #

Display only tags that are assigned to the post (or page) with a specified ID. If you need this option, you mostly want to “use this post”. The menu offers also some recent posts by title.


Groups #

Hide empty groups #

Whether to hide groups without tags.

Include groups #

Tag groups that will be considered in the tag cloud.

Use groups of the following post #

Display only groups of which at least one assigned tag is also assigned to the selectd post (or page). Matching groups will be added to the list specified by Include groups.


Columns #

Column count #

The number of columns.

Gap between columns #

Width of the gap between columns.

Avoid breaking groups over columns #

Try to keep the group header and its tags together in one block. That makes it easier to understand which tags belong to which group, but it might lead to empty spaces at the bottom of columns.


Advanced Styling #

You can set here IDs and classes to be referred to in CSS. You need some knowledge of CSS to use these options.

Title element #

Level of the HTML <h?> element.

div id #

Define an ID for the enclosing <div>.

  1. If you display more than one tag cloud on the same page, each shortcode needs a different value. The safest solution is to leave it empty so that div_id automatically receives a random value.
  2. Avoid words that are used by WordPress such as “content” or “main”. Each ID must be unique for the entire page.

div class #

Define a class for the enclosing <div>. Here you can apply some themes.

tags div class #

Define a class for the tags container.

header class #

Define a class for the header.