Skip to main content
Tags are named text snippets you save once and invoke on demand. Instead of retyping the same welcome message, FAQ answer, or server rule every time, you create a tag and call it with /tag <name>. Percy replies with the saved content immediately — no copy-pasting required. Tags are per-server: a tag you create in one server is not visible in another.

​
Commands

​
Examples

The first command saves a tag named welcome. The second invokes it and Percy replies with the content. The third creates an alias rules that displays the same content as welcome.

​
Creating a Tag

1

Choose a name

Tag names must be 100 characters or fewer and cannot be reserved command names. Names are case-insensitive when looked up.
2

Create the tag

Run /tag create <name> <content> for short content. For longer text with formatting, run /tag make to open a modal with a full text editor — no character limits from the command line.
3

Test it

Run /tag <name> to confirm Percy returns the right content.

​
List and Search Flags

Both /tag list and /tag search accept these optional flags:

​
Transferring a Tag

Run /tag transfer <@member> <name> to initiate a transfer. Percy sends a DM to the recipient with Accept and Decline buttons. The tag is placed in a pending state until they respond. If they accept, ownership transfers immediately. If they decline, ownership reverts to you.

​
Claiming an Abandoned Tag

If a tag owner leaves the server, run /tag claim <name> to take ownership. Percy checks that the original owner is no longer a member before allowing the claim.

​
Exporting Tags

/tag export personal sends you a CSV file of all your tags in the current server. /tag export server exports every tag in the server — this option is restricted to the server owner.
Tags are scoped to individual servers. Use /tag export and re-create them with /tag create (or a bulk import flow) if you want the same tags in multiple servers.
Members with Ban Members or Manage Messages can delete any user’s tags using /tag purge <member>. Regular members can only delete their own tags with /tag delete <name>.
Use /tag alias to give a tag multiple short names. For example, a tag named frequently-asked-questions can have aliases faq and help so members don’t need to remember the full name.