Tags Configuration
Learn how to create and manage custom tags
Creating Tags
Create custom commands for your server using the tag command.
Create a Tag
[p]tag create <name> <content>
Creates a new tag with the specified name and TagScript content.
Edit a Tag
[p]tag edit <name> <new content>
Updates an existing tag's content.
Delete a Tag
[p]tag delete <name>
Removes a tag from your server.
View Tags
[p]tag list
Shows all tags in your server.
[p]tag info <name>
Display information about a specific tag including uses, author, and creation date.
Tag Management
Tag Ownership
- Tags are owned by the user who creates them
- Server administrators can edit or delete any tag
- Tag owners can transfer ownership to another user
Transfer Ownership
[p]tag transfer <name> <@user>
Transfer ownership of a tag to another server member.
Aliasing Tags
[p]tag alias <new_name> <existing_tag>
Create an alias (alternative name) for an existing tag.
Permissions
Control who can use and manage tags in your server.
Required Permissions
- Create Tags: Any member by default (can be restricted)
- Edit Own Tags: Tag owner
- Edit All Tags: Server administrators
- Delete Tags: Tag owner or server administrators
Using Require & Blacklist
You can restrict tag usage within the tag content itself:
{require(Moderator):Only moderators can use this tag!}
{blacklist(Muted):You cannot use this while muted.}
Best Practices
- Use descriptive names: Make tag names easy to remember and type
- Test your tags: Try tags in a test channel before deploying
- Add cooldowns: Prevent spam with the cooldown block
- Handle errors: Use require blocks to validate input
- Document complex tags: Add comments for maintainability
- Keep it simple: Break complex tags into smaller, reusable ones
Tag Limits
- Tag Name Length: 1-50 characters
- Tag Content Length: Up to 2000 characters
- Embed Description: Up to 4096 characters
- Embed Fields: Maximum 25 fields per embed
- Total Embed Length: Maximum 6000 characters
- Tags per Server: Unlimited (subject to database limits)
Troubleshooting
Tag Not Working?
- Check for syntax errors in your TagScript
- Verify all blocks are properly closed
- Ensure required parameters are provided
- Check bot permissions in the channel
Common Errors
Missing Parameter: Make sure all required blocks have their parameters
❌ {if():message}
✅ {if({args}==test):message|else}
Unmatched Braces: Every opening { needs a closing }
❌ {user(name}
✅ {user(name)}
Getting Help
Need assistance with tags? Here's how to get support: