The ctx object

An attachment on a message.

• fileName (string)
• contentType (string)
• size (number)
• url (string)

Message data, present on message-related events.

• id (string)
• content (string)
• authorId (string)
• authorUsername (string)
• authorDisplayName (string): Discord display name (global_name), falling back to username when unset.
• authorAvatarUrl (string)
• channelId (string)
• attachments (AttachmentContext[])
• referencedMessageId (string): ID of the message this one replies to (empty when not a reply).
• isForwarded (boolean): True when the message is a forward.
• previousContent (string | null): On MessageUpdate, the content before the edit, or null when it isn't known (any other trigger, or a message not in the 30-minute cache).
• createdAt (string): ISO 8601 time the message was posted. On MessageDelete this comes from the 30-minute cache, so it is empty for an older message.
• editedAt (string | null): ISO 8601 time of the last edit, or null if it has never been edited.
• authorIsBot (boolean): Whether the author is a bot or webhook (only ever true with the allowBots filter on).
• mentionedUserIds (string[]): User IDs the message mentions; a reply's implicit ping counts.
• mentionedRoleIds (string[])
• mentionsEveryone (boolean): Whether it pinged @everyone/@here, and the author had permission to.
• isPinned (boolean)

Member data. ctx.member on member-related events, and ctx.actor anywhere there is a ctx.actorId.

• userId (string)
• username (string)
• displayName (string): Nickname, else global display name, else username.
• discriminator (string): Legacy; Discord retired discriminators. Empty on cache-backed ctx.actor.
• nickname (string)
• avatarUrl (string): Server avatar, else global avatar, else Discord's default. Never empty.
• roleIds (string[])
• joinedAt (string): ISO 8601 join timestamp (empty when unknown).
• isBot (boolean | null): The fields below are null when the member came from Mallard's member cache (getMember/listMembers, and ctx.actor outside commands), which does not store them. Null means "this source can't say", not false.
• premiumSince (string | null): ISO 8601 time they started boosting, or null if they never have.
• timeoutUntil (string | null): ISO 8601 timeout expiry. A PAST time means an expired timeout, so compare it against now rather than testing for null.
• isPending (boolean | null): True while they still have membership screening (the rules gate) to pass.
• serverMuted (boolean | null)
• serverDeafened (boolean | null)

Voice state data, present on VoiceStateUpdate events. Discord sends the whole state on every change and never says what changed, so compare against your own stored copy to tell a channel move from someone starting a stream.

• userId (string)
• channelId (string): Voice channel the user is now in; empty when they disconnected.
• selfMuted (boolean)
• selfDeafened (boolean)
• serverMuted (boolean): Muted by a moderator, so they cannot unmute themselves.
• serverDeafened (boolean)
• streaming (boolean): Screen-sharing / "going live".
• video (boolean): Camera on.
• suppressed (boolean): On a stage channel, in the audience rather than speaking.
• requestedToSpeakAt (string): ISO 8601 stage "request to speak" time (empty when there is none).

A forum tag, applied to a post (ctx.thread.tags) or defined on a forum (getForumTags).

• id (string)
• name (string)
• emojiName (string): Unicode emoji on the tag (empty when none or when the tag uses a custom emoji).
• emojiId (string): Custom emoji ID on the tag (empty when none or when the tag uses a unicode emoji).
• moderated (boolean): Whether only moderators can add/remove this tag.

New thread / forum post data, present on ThreadCreate events.

• id (string): ID of the new thread / forum post (same as ctx.channelId).
• name (string): The thread / forum post title.
• ownerId (string): User who created it (same as ctx.actorId).
• parentId (string): Channel the thread was created under (the forum channel for a forum post).
• parentType (string): Parent channel kind: "Forum", "MediaForum", "Announcement", "Text", or "Unknown".
• isForumPost (boolean): True when the parent is a forum/media channel, meaning this thread is a forum post.
• tags (ForumTag[]): Forum tags applied to this post, resolved to names (empty for non-forum threads).
• archived (boolean): Whether the thread is archived (closed). ThreadUpdate is the only place archiving and reopening are visible. False on ThreadDelete.
• locked (boolean): Locked: only moderators can unarchive it.
• autoArchiveDuration (number): Idle minutes before auto-archive: 60, 1440, 4320 or 10080.
• archivedAt (string): ISO 8601 time of the last archive/unarchive (empty when unknown).
• messageCount (number): Messages in the thread; Discord stops counting at 50 on older threads.
• memberCount (number): Members who joined the thread; Discord stops counting at 50.

Ban data, present on GuildBanAdd / GuildBanRemove events.

• userId (string): The banned (GuildBanAdd) or unbanned (GuildBanRemove) user's ID.
• username (string)
• displayName (string): Global display name, falling back to the username. There is no nickname: by the time this fires they are not a member any more.
• avatarUrl (string): Avatar URL, never empty (falls back to Discord's default).
• isBot (boolean)

Submitted form data, present on FormSubmitted events.

• formId (string): The form's GUID, as it appears in its public URL.
• formName (string): The form's name, e.g. "Ban Appeal".
• submissionId (string): This submission's GUID, matching the id stored in forms:submissions:<formId>.
• platform (string): Which identity the submitter proved: "Discord", "Twitch", or "Anonymous" on a form that requires none.
• submitterId (string): The submitter's ID on that platform (not a Discord snowflake for Twitch submitters). Empty when anonymous.
• submitterDisplayName (string): Empty when anonymous.
• answers ({ [label: string]: string }): Each field's answer, keyed by the field's label exactly as it read when the form was submitted. Labels are unique within a form. A field left blank is present with an empty string.
• answersText (string): Every answer pre-rendered as "**Label**\nvalue" blocks, for pasting straight into a message or embed. The only way to show answers from an Easy Mode block, which cannot index into answers.

Invite data, present on InviteCreate / InviteDelete events.

• code (string): The invite code (the part after discord.gg/).
• channelId (string)
• inviterId (string): Inviter's user ID (empty on InviteDelete).
• maxUses (number): Max uses before expiry (0 = unlimited; 0 on InviteDelete).
• maxAge (number): Lifetime in seconds (0 = never; 0 on InviteDelete).
• temporary (boolean)
• expiresAt (string): ISO 8601 expiry time (empty when it never expires or on InviteDelete).
• uses (number): Times used. Always 0 on InviteCreate; an invite tracker counts with getInvites().
• createdAt (string): ISO 8601 creation time (empty on InviteDelete).
• inviterUsername (string): The inviter's username (empty on InviteDelete).
• inviterDisplayName (string): The inviter's display name, falling back to username (empty on InviteDelete).

Scheduled-event data, present on the GuildScheduledEvent* triggers.

• id (string)
• name (string)
• description (string)
• channelId (string): Voice/stage channel (empty for external-location events).
• location (string): Physical location for external events (empty otherwise).
• creatorId (string): Event creator's user ID (empty when unknown or on user add/remove).
• entityType (string): Entity kind: "StageInstance", "Voice", or "External".
• status (string): Lifecycle status: "Scheduled", "Active", "Completed", or "Canceled".
• startsAt (string): ISO 8601 scheduled start time.
• endsAt (string): ISO 8601 scheduled end time (empty when open-ended).
• userId (string): The (un)subscribing user (GuildScheduledEventUserAdd/Remove only; empty otherwise).
• userCount (number): How many members have RSVP'd (0 on the user add/remove triggers).
• privacyLevel (string): Always "GuildOnly"; Discord has never shipped another value.
• coverImageUrl (string): Cover image URL (empty when it has none).

Poll-vote data, present on MessagePollVoteAdd / MessagePollVoteRemove events.

• userId (string)
• messageId (string)
• channelId (string)
• answerId (number): ID of the poll answer that was voted for / removed.

Stage-instance data, present on StageInstanceCreate/Update/Delete events.

• id (string)
• channelId (string): The stage voice channel this instance is live in.
• topic (string)
• privacyLevel (string): Privacy level: "Public" or "GuildOnly".
• discoverableDisabled (boolean): Hidden from Stage Discovery.

The server's settings as they stand after a GuildUpdate. Discord sends the whole guild and never says which field moved, so to detect "the name changed" keep your own copy in the KV store and compare.

• name (string)
• description (string)
• ownerId (string)
• iconUrl (string): Empty when unset.
• bannerUrl (string)
• vanityUrlCode (string): The discord.gg vanity code (empty when the server has none).
• premiumTier (number): Boost level, 0-3.
• boostCount (number)
• verificationLevel (string): "None", "Low", "Medium", "High" or "VeryHigh".
• explicitContentFilter (string): "Disabled", "MembersWithoutRoles" or "AllMembers".
• nsfwLevel (string): "Default", "Explicit", "Safe" or "AgeRestricted".
• preferredLocale (string): The server's primary locale, e.g. "en-GB".
• features (string[]): Feature flags, e.g. "COMMUNITY", "ANIMATED_BANNER".
• afkChannelId (string): Empty when unset.
• systemChannelId (string)
• rulesChannelId (string)

Emoji/sticker set data, present on GuildEmojisUpdate / GuildStickersUpdate events.

• kind (string): Which set changed: "emojis" or "stickers".
• count (number): Number of items in the set after the change.
• names (string[]): Names of the items in the set after the change.
• ids (string[]): IDs of the items, positionally matching names. Discord sends the whole set rather than a delta, so store this and diff it next time to learn what was added or removed; names alone cannot tell a rename from a replacement.

A single Twitch chat message inside a TwitchChatBatch.

• chatterId (string)
• chatterLogin (string)
• chatterDisplayName (string)
• text (string)
• rewardId (string): Channel-points reward id when the message was a text-input redemption (empty otherwise).
• bits (number): Number of bits cheered with this message (0 otherwise).
• sentAt (string): ISO 8601 timestamp the message was received.

Twitch event data, present on Twitch* triggers.

• broadcasterId (string)
• broadcasterLogin (string)
• title (string): Stream/channel title (TwitchChannelUpdate only; empty otherwise).
• category (string): Game/category name (TwitchChannelUpdate only; empty otherwise).
• startedAt (string): ISO 8601 stream start time (TwitchStreamOnline only; empty otherwise).
• messages (TwitchChatMessage[]): Chat messages from the last ~10 minutes (TwitchChatBatch only; empty otherwise).
• messagesDropped (number): Messages dropped from this batch because the per-guild buffer overflowed.

Component interaction data, present on ButtonClick and the ": Modal" triggers.

• customId (string)
• payload (string): Free-form payload set on the button that triggered this.
• userId (string)
• messageId (string): Message the component was attached to (empty for form submissions).
• channelId (string)
• values (Record<string, string>): Modal text-input values keyed by input id (empty for button clicks).

Reaction data, present on MessageReactionAdd events.

• userId (string)
• messageId (string)
• channelId (string)
• emojiId (string)
• emojiName (string)
• emojiAnimated (boolean): Whether the custom emoji is animated (false for unicode emoji).
• messageAuthorId (string): Who wrote the reacted-to message. MessageReactionAdd only, so empty on the three removal triggers; a starboard uses it to skip self-reactions.
• burst (boolean): Whether this was a "super reaction". MessageReactionAdd only.

Bulk delete data, present on MessageBulkDelete events.

• messageIds (string[])
• count (number)
• channelId (string)
• messages (CachedMessage[]): The deleted messages, recovered from the 30-minute cache. A SUBSET of messageIds, oldest-first, and empty when a purge cleared older history: Discord itself sends only the IDs.