---
title: Tag List – Shortcode Parameters
description: "This guide shows you how to use and customize the shortcode for the Tag List feature in the [Tag Groups](https://publishpress.com/links/tag-groups) plugin. --- ## Shortcode ``` [tag_groups_tag_list] ``` --- ## Example ``` [tag_groups_tag_list append=\"{count}\"] ``` --- ## Data Types - **string:**…"
url: "https://publishpress.com/knowledge-base/tag-list-parameters/"
updated: "2026-10-15"
category: PublishPress Tag Groups / Tag List
---

# Tag List – Shortcode Parameters

This guide shows you how to use and customize the shortcode for the Tag List feature in the [Tag Groups](https://publishpress.com/links/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.

| **Default** | **Possible Values** | **Example** |
| --- | --- | --- |
| 0 (false) | 0 or 1 | `add_premium_filter=1` |

### 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

| **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, then H4 etc.. 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 | `hide_empty=0` |

### 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

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` |