Skip to content

Tag and Trigger Commands

Tags are custom commands with TagScript content; triggers are autoresponders that fire on matching messages. Both are also managed on the Tags & Triggers Dashboard page. TagScript itself, presets and the editor: Custom Commands & Tags.

Tags — /tag

Using tags

Command Description
/tag get <name> [args] Run a tag, passing optional arguments to {args}
/tag preview <name> [args] Render a tag without counting a use
/tag random Run a random tag from this Server
/tag list [category] [creator] [sort] List tags, filtered by category or creator; sort by name, most used, newest or oldest
/tag search <query> Search tag names and content
/tag top [limit] The most used tags (default 10, max 25)
/tag info <name> Owner, uses, category and restrictions of a tag
/tag raw <name> The unprocessed TagScript of a tag
/tag syntax [topic] TagScript reference, by topic

Writing tags

Command Description
/tag create <name> <content> Create a tag (name up to 100 characters; content supports TagScript blocks like {user} and {args})
/tag edit <name> <content> Replace a tag's content
/tag editor <name> Edit an existing tag's content in a text modal
/tag append <name> <content> Add text to the end of a tag
/tag delete <name> Delete a tag
/tag alias <alias_name> [target] Point an alias at a tag; omit target to delete the alias

Managing tags

Command Description
/tag enable <name> Enable a disabled tag
/tag disable <name> Disable a tag without deleting it
/tag nsfw <name> <enabled> Restrict a tag to NSFW channels
/tag restrict <name> [allow_role] [deny_role] [allow_channel] [deny_channel] [clear] Limit who can use a tag and where; clear removes every restriction
/tag transfer <name> <new_assignee> Hand a tag to another Member
/tag claim <name> Claim a tag whose creator left the Server
/tag export Download every tag as a JSON file
/tag import_tags <file> Import tags from a JSON file made by /tag export

Triggers — /trigger

Command Description
/trigger create <name> <content> [match_type] [case_sensitive] [threshold] [exclude] Create an autoresponder. match_type: contains (default), exact, starts with, ends with, regex, or keywords; threshold is the share of keywords that must appear (keywords only); exclude is a second regex that vetoes a match (regex only)
/trigger edit <name> <content> [exclude] Replace a trigger's response; pass an empty exclude to clear the veto pattern
/trigger delete <name> Delete a trigger
/trigger toggle <name> <enabled> Enable or disable a trigger
/trigger list List every trigger in this Server
/trigger info <name> A trigger's pattern, match type and response

Common Examples

/tag create name:rules content:"Read {channel(#rules)} before posting, {user}."
/tag get name:rules
/tag restrict name:lfg allow_channel:#looking-for-group
/trigger create name:"gg" content:"Good game, {user}!" match_type:Exact