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.
If you don’t know what is a shortcode and how to use it, you first may want to read this article.
[tag_groups_alphabetical_index]
[tag_groups_alphabetical_index column_count=2]
- 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.
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.
the maximum number of tags per group to display
Default | Possible Values | Example |
0 (no limit) | integer | amount=10 |
adds something behind the tag name; placeholder: {count} for post count
Default | Possible Values | Example |
empty | string | append= ” ({count})” |
number of columns; for responsive design follow these instructions
Default | Possible Values | Example |
2 | integer | column_count=3 |
width of the gap between columns
Default | Possible Values | Example |
10px | string | column_gap=20px |
tooltip when hovering the mouse over a tag; placeholder: {count} for post count
Default | Possible Values | Example |
depends on show_tag_count | string | custom_title="We found {count} post(s)" |
class of the enclosing div for own styling
Default | Possible Values | Example |
tag-groups-tag-list | string | div_class="my-class" |
ID of the enclosing div
Default | Possible Values | Example |
random | string (must be unique on the page) | div_id="my-id" |
letters/characters that should not appear in the list
Default | Possible Values | Example |
empty | string | exclude_letters=0123456789 |
a list of tags that should not appear
Default | Possible Values | Example |
empty | comma-separated list of tag IDs | exclude_terms= |
<h3>/h3>, <h4></h4>, … of the headings with the group names
Default | Possible Values | Example |
3 | integer | h_level=2 |
class for the headers
Default | Possible Values | Example |
empty | string | header_class="my-class" |
hide tags with post count zero
Default | Possible Values | Example |
1 | 0 or 1 | hide_empty=0 |
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 |
groups to include
Default | Possible Values | Example |
all | comma-separated list of group IDs | include=2,3,5 |
which first letters to use
Default | Possible Values | Example |
all initials of the displayed tags | string | include_letters=abcdz |
tags to include (see also “hide_empty”)
Default | Possible Values | Example |
all | comma-separated list of tag IDs | include_terms=12,34,255 |
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 |
max. font size in pt
Default | Possible Values | Example |
12 | integer | largest=32 |
target attribute of the tag link (_blank, _top, _self, …)
Default | Possible Values | Example |
empty | string | link_target="_top" |
append query to the link
Default | Possible Values | Example |
empty | string | link_append= “source=cloud” |
Customize the locale (language-specific setting) that is used for sorting the first letters (initials). By default we use the language setting of your site. This sort order affects only the order of the first letters, not the tag order (see “orderby” and “order”).
Accepted values depend on which locales PHP can use on your server. They can have formats like “fr”, “fr_FR” or “fr_FR.UTF8”. Please ask your provider if you cannot find it by guessing or googling.
accepted values | default | example shortcode |
---|---|---|
string | empty (site locale) | locale="fr_FR.UTF8" |
If you turn this on, then accented (or umlaut) letters will be treated like normal letters. For a list of changes see remove_accents.
accepted values | default | example shortcode |
---|---|---|
0 or 1 | 0 | ignore_accents=1 |
ascending or descending order; use with orderby
Default | Possible Values | Example |
asc | string (asc or desc) | order=desc |
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 to the tag; placeholder: {count} for post count
Default | Possible Values | Example |
empty | string | prepend="#" |
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 |
min. font size in pt
Default | Possible Values | Example |
12 | integer | smallest=14 |
class name for the divs around tags
Default | Possible Values | Example |
empty | string | tags_div_class="my-class" |
Use post ID or zero for current post.
Default | Possible Values | Example |
-1 (not used) | integer | tags_post_id=0 |
taxonomies (tag types) to use
Default | Possible Values | Example |
all selected in the settings | comma-separated list of taxonomy names/slugs | taxonomy=product_tag |