Notes Cog

The Notes cog lets moderators (and optionally a set of non-moderator “Advisor” roles) keep timestamped notes on server members — warnings, behavioral history, or anything worth remembering the next time someone looks that member up. Every note carries a full edit history, and every add/edit/delete/clear/transfer/type-change is logged to a configurable log channel.

Every command works as both a slash command (/note ...) and a prefix command (!note ...) — they’re the same command, just two ways of invoking it.

Permission tiers

  • Moderators — anyone with the Manage Messages permission. Can add, edit, view, and delete any note (Moderator or Advisor type), from any channel.
  • Advisors — members holding one of the roles set in Advisor Roles. Can add, edit, view, and delete notes, but:
    • They only ever see Advisor-type notes (Moderator notes are invisible to them).
    • They can only delete a note if they’re the one who wrote it.
    • If Allowed Channel is configured, they can only use these commands there (or in a thread under it). Moderators are never restricted by this.
    • Notes an Advisor adds are automatically tagged as Advisor-type.
  • Clear and Transfer additionally require the Ban Members permission, regardless of Advisor Roles — see Moderation for how that fits alongside the rest of the mod toolkit.

Commands

Command Description Permissions
/note add <user> <note> or !note <user> <note> Add a note to a user (max 990 characters) Moderator or Advisor
/note edit <note_id> <note> Edit an existing note’s content (adds an entry to its edit trail) Moderator, or the Advisor who wrote it
/note delete <note_id> (alias remove) Delete a note and its edit trail Moderator, or the Advisor who wrote it
/note clear <user> [reason] Delete all notes for a user Ban Members
/note transfer <user> <user2> [reason] Move all of a user’s notes onto another user (e.g. for alt accounts) Ban Members
/note info <note_id> View a single note by ID, paginated with its edit history if it has one Moderator or Advisor
/note type <note_id> <type> Reclassify a note as Moderator/Mod or Advisor Manage Messages
/note help Show an in-Discord command summary None
/notes <user> [advisor_only] or !notes <user> View all notes for a user, 10 per page, with Edit/Delete buttons. Moderators can pass advisor_only: true to see only Advisor notes Moderator or Advisor
Show user notes (user context menu) View a user’s notes ephemerally, ignoring the Allowed Channel restriction Moderator or Advisor
Show author notes (message context menu) Same as above, for a message’s author Moderator or Advisor

Notes are capped at 990 characters. /notes and /note info results include a select menu + Edit/Delete buttons so you don’t need to re-run a command with the note ID once you’ve found it.

Configuration

Configure the cog with /config cog Notes:

  • Enabled — Turn the Notes system on or off for this server. Enabled by default.
  • Log Channel — Single channel where every note action (add, edit, delete, clear, transfer, type change) is logged.
  • Allowed Channel — Up to 10 channels/threads where Advisors are permitted to use Notes commands. Leave empty to let Advisors use Notes anywhere. Moderators are never restricted by this setting.
  • Advisor Roles — Up to 25 roles that get non-moderator access to the Notes system, per the permission tiers above.
  • Success Emoji — The emoji shown on successful command invocations (defaults to :white_check_mark:).

Best Practices

  1. Keep notes professional and factual — they’re a shared record, not a place for personal opinions.
  2. Use Advisor Roles to extend note-taking to trusted helpers without giving them moderator-level visibility — they’ll only ever see Advisor-tagged notes.
  3. Set an Allowed Channel if you want Advisor note-taking confined to a specific mod-adjacent channel, rather than usable anywhere in the server.
  4. Use /note transfer when a user is confirmed to be operating an alt, so their history stays together under one account.
  5. Reach for /note type if a note was filed under the wrong tier — for example, reclassifying an Advisor note to Moderator once it escalates.
  6. Review old notes periodically; the edit trail on /note info makes it easy to see exactly how a note has evolved over time.