Tags Cog

The Tags cog provides a comprehensive system for storing, organizing, and retrieving reusable text responses, embeds, and information. Tags are perfect for frequently asked questions, server information, and quick responses.

Features

Tag Management

  • Create, edit, and delete tags for server-wide use
  • Support for text, embeds, and images
  • Multiple aliases for same tag
  • Full edit history tracking

Organization

  • Organize tags into categories
  • Add searchable keywords to tags
  • Track contributor information
  • Support for mixed content types

Content Support

  • Plain text tags
  • Discord embeds with rich formatting
  • Image and attachment support
  • Combined text and media

Commands

Basic Tag Commands

| Command | Description | |———|————-| | /tag get <name> | Display a tag | | /tag create <name> <content> | Create a new tag | | /tag edit <name> <content> | Edit an existing tag | | /tag delete <name> | Delete a tag | | /tag raw <name> | Get raw tag content (without formatting) |

Tag Information

| Command | Description | |———|————-| | /tag info <name> | View tag metadata and details | | /tag list | Browse all tags | | /tag search <query> | Search for tags by name or content |

Tag Aliases

| Command | Description | |———|————-| | /tag alias <tag> <alias> | Create an alias for a tag | | /tag unalias <alias> | Remove a tag alias |

Keyword Management

| Command | Description | |———|————-| | /tag keywords add <tag> <keyword> | Add keyword to a tag | | /tag keywords remove <tag> <keyword> | Remove keyword from tag | | /tag keywords list [tag] | View keywords (optionally filtered by tag) | | /tag keywords search <keyword> | Search tags by keyword | | /tag keywords missing | View tags without keywords |

Prefix Commands

| Command | Description | |———|————-| | !tag <name> or !get <name> | Display a tag | | !raw <name> | Get raw tag content | | !info <name> | View tag information | | !tags or !tag list | List all tags | | !tag search <query> | Search tags |

Configuration

Customize your tags system with these settings:

  • Enabled - Toggle the tags system
  • Log Channel - Where tag actions are logged
  • Roles Call Tags - Roles allowed to use tags
  • Roles Create Tags - Roles allowed to create and edit tags
  • Roles Manager - Roles managing the tag system
  • Roles Blacklisted - Roles blocked from using tags

Best Practices

  1. Clear Naming: Use descriptive, searchable tag names
  2. Categorization: Organize tags logically
  3. Regular Updates: Keep information current
  4. Keyword Addition: Add relevant keywords for search
  5. Moderation: Review new tags before approval

Integration

The tags system integrates with:

  • Help System: Auto-suggest relevant tags
  • Moderation: Use tags for warning templates
  • Welcome System: Automated welcome tags
  • FAQ System: Centralized knowledge base

Permissions

  • Users: Can view and use public tags
  • Contributors: Can create and edit their own tags
  • Moderators: Can manage all tags and categories
  • Admins: Full control over the system