Tag Display

FAQ

How do I use the plugin?

Activate the plugin, go to Settings → Tag Display to configure your preferences, then add tags to your posts in one of three ways:

1. Shortcode — paste [s7n_tag_display] anywhere in a post or page.
2. Gutenberg block — search for «Tag Display» in the block inserter and add it to your content.
3. Automatic — enable auto-display in Settings → Content Types and tags will appear automatically in every post.

Can I change the template style?

Yes. Choose between Default, Minimal, Cloud, Outlined, and Hashtag templates:

• From the settings page: Settings → Tag Display → General Settings → Default Template.
• Via shortcode: [s7n_tag_display template="outlined"]
• Via Gutenberg block: select the block and use the Template option in the sidebar.

How do I use the Gutenberg block?

In the block editor, click the + button and search for «Tag Display». Add the block to your post. Use the sidebar panel (Display Settings, Link Options, Title) to override the template, ordering, tag limit, and other options for that specific block — independently of the global settings.

What shortcode attributes are available?

All attributes are optional and override the global settings for that specific instance:

[s7n_tag_display template="hashtag" order="count_desc" max="8" exclude="news,draft" nofollow="true" new_tab="true" show_count="true" title="Related topics:"]

• template — default, minimal, cloud, outlined, hashtag
• order — alpha_asc, alpha_desc, count_desc, count_asc, random (default: global setting)
• max — maximum number of tags to show, e.g. max="5" (0 = all)
• exclude — comma-separated slugs to hide, e.g. exclude="news,uncategorized"
• nofollow — true to add rel="nofollow" to tag links
• new_tab — true to open links in a new tab
• show_count — true to show the post count next to each tag, e.g. WordPress (12)
• title — custom label above the tags, e.g. title="Topics:" (empty string hides the title)

How do I limit or sort the tags?

Go to Settings → Tag Display → General Settings. You can set:

• Tag Order — alphabetical (A→Z / Z→A), by post count (most/least used), or random.
• Max Tags — show only the first N tags (0 = show all).
• Exclude Tags — comma-separated slugs of tags to always hide.

These settings can also be overridden per-instance via shortcode or Gutenberg block.

How do I hide specific tags?

In Settings → Tag Display → General Settings → Exclude Tags, enter the slugs (not names) of the tags you want to hide, separated by commas. Example: news, uncategorized, draft.

To find a tag’s slug, go to Posts → Tags in the WordPress admin.

Can I display tags automatically without a shortcode?

Yes. Go to Settings → Tag Display → Content Types, enable auto-display for posts, pages, or custom post types, and choose whether tags appear before or after the content.

How do I add rel=»nofollow» or open links in a new tab?

Go to Settings → Tag Display → General Settings and enable the rel=»nofollow» or Open in new tab checkboxes. These can also be set per-instance via shortcode (nofollow="true", new_tab="true") or Gutenberg block sidebar.

Can I create a fully custom template from my theme?

Yes. Place a file named tag-display-template-{name}.php in your theme (or child theme) root folder, where {name} is the template you want to override: default, minimal, cloud, outlined, or hashtag.

Example: to override the default template, create wp-content/themes/your-theme/tag-display-template-default.php.

The plugin detects and uses it automatically. A fully commented example file is included in the plugin’s examples/ folder.

The following variables are available in your custom template:

• $tags — array of WP_Term objects (->name, ->slug, ->count)
• $display_title — label text above the tags
• $display_nofollow — boolean, whether to add rel="nofollow"
• $display_new_tab — boolean, whether to open links in a new tab
• $display_show_count — boolean, whether to show post count next to each tag

Is it compatible with the latest WordPress version?

Yes, Tag Display is regularly updated to ensure compatibility.