# Tags

> Save and recall snippets of text

Tags store a piece of text you can call up later, for FAQs, rules or canned replies.

<discord-messages class="not-prose">
	<discord-message profile="you">/tags rules</discord-message>
	<discord-message profile="aethor">
		Be kind, keep it on topic, and no spam. Full rules are in #welcome.
	</discord-message>
</discord-messages>

## Setup

- `/tag create` makes a tag with a name and content.
- `/tag delete` removes one.
- `/tag update` syncs your tags into real slash commands (see below).
- `/tags <name>` shows a tag. Add `embed:true` for an embed or select `ping:@someone` to mention a user. `/tag view` and `/tag list` remain available for the grouped command.

<Cmd cmd="/tag create name:rules content:Be kind, keep it on topic, and no spam." />

Run in a server, tags belong to that server. Run in a DM, they are personal to you.

## Limits and permissions

- Free servers get 20 tags, Premium gets 200. Personal tags in DMs are capped at 20.
- Tag names cannot contain spaces and are limited to 20 characters. Names intended to become slash commands must be 2 to 20 characters using lowercase letters, digits and hyphens.
- `/tag update` only works in a server, so personal tags cannot become slash commands.
- Only the first 50 tags are registered as commands.
- Tags with uppercase letters or other invalid characters can still exist, but `/tag update` skips them.

After `/tag update`, run the generated tag command, `/tags <name>`, or `/tag view` to verify the content. Run `/tag update` again after changing a tag name or adding a tag you want to expose as a slash command.