Documentation menu

Docs/Plugins/Tags

Tags

Save and recall snippets of text.

Tags are named snippets anyone (with the level you choose) can recall - FAQ answers, rule quotes, copy-pasta your server insists on keeping.

plugins:
  tags:
    max_tag_length: 1900
    min_level_remove_others: 50   # who may delete other people's tags

Tags belong to their author; moderators at min_level_remove_others and above can remove anyone's. The dashboard's Tags page lists, edits, and deletes them with usage counts.

Content tokens

Tag content supports placeholders, filled in when the tag is used:

  • {user} / {mention} - mentions the person who used the tag (or the -u target, see below)
  • {channel} - the channel the tag was used in (or the -c target)
  • {server} - the server name
  • {u<id>} / {r<id>} / {c<id>} - mention a specific user, role, or channel by ID

User and role mentions in tag content ping for real (embeds are the exception - Discord never notifies from inside an embed). @everyone and @here are always suppressed in tags, no matter who wrote them.

Directing a tag

Both !tag <name> and the bare !<name> form take flags, in any position after the name:

  • -u @someone (or --user) directs the tag at them: {user} tokens become that person, and if the tag has no {user} token they get pinged above the content.
  • -c #channel (or --channel) posts the tag to another channel.
  • -e (or --embed, !tag only) renders the tag inside an embed.

Commands

Command What it does
/tag Run a guild tag by name. Supports -c #channel, -u @user, -e (embed).
/tags create Create a tag - invokable in chat as .
/tags edit Edit an existing tag's content.
/tags remove Delete a tag.
/tags info Show a tag's metadata (author, times used, content).
/tags list List every tag in this guild.
/tags owner Reassign a tag's ownership to another user.