Event variables

When an event runs, DogeBot tells your blocks what happened with values that start with event_. For example, in When a new user joins the server, {event_user_mention} pings the person who joined.

Welcome {event_user_mention}! You are member number {server_members}.

Open a group below to see every event in it and the values it gives you. In the builder, the variable list only shows the values that work in the event you picked.

The normal values like {server} and {server_members} work in events too. In events about a person, {user_name} and friends are about that person as well.

These come up again and again, so here they are once.

About the person
About the server
About the channel
About the message

Value	What it is
`{event_user_id}`	Their ID
`{event_user_name}`	Their username
`{event_user_username}`	Their username
`{event_user_mention}`	Pings them
`{event_user_avatar}`	A link to their profile picture
`{event_user_tag}`	Their full tag

Value	What it is
`{event_guild_id}`	The server ID
`{event_guild_name}`	The server name

Value	What it is
`{event_channel_id}`	The channel ID
`{event_channel_name}`	The channel name
`{event_channel_parent_id}`	The category ID (or the forum, for a forum post)
`{event_channel_parent_name}`	The category name
`{event_channel_is_thread}`	true if it is a thread
`{event_parent_channel_id}`	The category ID

Value	What it is
`{event_message_id}`	The message ID
`{event_message_content}`	What the message says
`{event_message_createdAt}`	When it was sent
`{event_message_channel}`	Mentions the channel
`{event_message_channel_id}`	The channel ID
`{event_message_channel_name}`	The channel name
`{event_message_channel_type}`	What kind of channel
`{event_message_has_attachments}`	true if it has files
`{event_message_attachments_count}`	How many files
`{event_message_attachment_1}`	A link to the first file
`{event_message_attachments}`	Links to all files
`{event_message_has_poll}`	true if it has a poll
`{event_message_poll_question}`	The poll question

Every event

Member events

When a new user joins the server

Has the values about the person and the server.

When a user leaves or is kicked from the server

Has the values about the person and the server.Plus:

Value	What it is
`{event_member_roles}`	The IDs of the roles they had, split with commas. Handy for giving roles back if they rejoin.

When a user is banned from the server

Has the values about the person and the server.Plus:

Value	What it is
`{event_ban_reason}`	Why they were banned

When a user is unbanned from the server

Has the values about the person and the server.

When a role is added to a user

Has the values about the person and the server.Plus:

Value	What it is
`{event_role_id}`	The role ID
`{event_role_name}`	The role name

When a role is removed from a user

Has the values about the person and the server.Plus:

Value	What it is
`{event_role_id}`	The role ID
`{event_role_name}`	The role name

When a guild member is updated

Has the values about the person and the server.

When a user changes their nickname

Has the values about the person and the server.Plus:

Value	What it is
`{event_new_nickname}`	The new nickname
`{event_old_nickname}`	The old nickname

When a user's status changes

Has the values about the person and the server.Plus:

Value	What it is
`{event_new_status}`	The new status
`{event_old_status}`	The old status

When member passes membership screening

Has the values about the person and the server.

Message events

When a new message is sent

Has the values about the person, the channel and the message.

When a message is updated or edited

Has the values about the person, the channel and the message.Plus:

Value	What it is
`{event_new_content}`	The message after the change
`{event_old_content}`	The message before the change

When a message is deleted

Has the values about the person, the channel and the message.

When a message is pinned

Has the values about the channel.

User Started Typing

Has the values about the person, the server and the channel.

Reaction events

In reaction events, the person is whoever reacted. The event_message_author_ values are about whoever wrote the message.

When a reaction is added to a message

Has the values about the person, the channel and the message.Plus:

Value	What it is
`{event_reaction_emoji}`	The emoji used
`{event_reaction_count}`	How many of this reaction the message has now
`{event_message_author_id}`	The ID of who wrote the message
`{event_message_author_name}`	Their username
`{event_message_author_mention}`	Pings them
`{event_message_author_avatar}`	A link to their profile picture
`{event_message_url}`	A link that jumps to the message
`{event_message_image}`	A link to the message’s first picture, if it has one

When a reaction is removed from a message

The same values as When a reaction is added. {event_reaction_count} is the count after it was removed.

All Reactions Removed

Has the values about the person, the channel and the message.

Specific Reaction Removed

Has the values about the person, the channel and the message.Plus:

Value	What it is
`{event_reaction_emoji}`	The emoji used

Voice events

Every voice event has the values about the person and the server, plus:

Value	What it is
`{event_voice_channel_id}`	The voice channel ID
`{event_voice_channel_name}`	The voice channel name

The voice events are: joins, leaves, starts streaming, stops streaming, is server muted, self mutes, is server unmuted, self unmutes, is server deafened, self deafens, is server undeafened and self undeafens.

When a member switches voice channels

Has the values about the person and the server.Plus:

Value	What it is
`{event_new_channel_id}`	The voice channel they moved to
`{event_old_channel_id}`	The voice channel they left
`{event_voice_channel_name}`	The voice channel name

Channel events

When a channel is created

Has the values about the server and the channel.

When a channel is updated

Has the values about the channel.Plus:

Value	What it is
`{event_old_name}`	The old name

When a channel is deleted

Has the values about the server and the channel.

When a channel's permissions are updated

Has the values about the channel.

When a channel's topic is updated

Has the values about the channel.Plus:

Value	What it is
`{event_new_topic}`	The new topic
`{event_old_topic}`	The old topic

Channel Pins Updated

Has the values about the channel.Plus:

Value	What it is
`{event_pins_updated_at}`	When the pins changed

Thread events

When a thread is created

Has the values about the server and the channel.Plus:

Value	What it is
`{event_thread_id}`	The thread ID
`{event_thread_name}`	The thread name

When a thread is updated or deleted

Has the values about the server.Plus:

Value	What it is
`{event_thread_id}`	The thread ID
`{event_thread_name}`	The thread name

Thread List Synchronized

Has the values about the server.Plus:

Value	What it is
`{event_thread_count}`	How many threads
`{event_thread_ids}`	All the thread IDs

Thread Members Updated

Has the values about the channel.Plus:

Value	What it is
`{event_added_count}`	How many people were added
`{event_added_member_ids}`	IDs of the people added
`{event_removed_count}`	How many people were removed
`{event_removed_member_ids}`	IDs of the people removed
`{event_thread_id}`	The thread ID
`{event_thread_name}`	The thread name

Thread Member Updated

Has the values about the person.Plus:

Value	What it is
`{event_thread_id}`	The thread ID
`{event_thread_name}`	The thread name

Role events

When a role is created or deleted

Has the values about the server.Plus:

Value	What it is
`{event_role_id}`	The role ID
`{event_role_name}`	The role name

When a role is updated

Has the values about the server.Plus:

Value	What it is
`{event_old_role_name}`	The old role name
`{event_role_id}`	The role ID
`{event_role_name}`	The role name

Boost events

When a member boosts the server for the first time

Has the values about the person and the server.

When a member unboosts the server

Has the values about the person and the server.

When the server boost level increases or decreases

Has the values about the server.Plus:

Value	What it is
`{event_boost_level}`	The boost level (0 to 3)

Server events

When guild name changes

Has the values about the server.Plus:

Value	What it is
`{event_old_guild_name}`	The old server name

When guild features are updated

Has the values about the server.Plus:

Value	What it is
`{event_new_features}`	The new features list
`{event_old_features}`	The old features list

When guild ownership changes

Has the values about the server.Plus:

Value	What it is
`{event_new_owner_id}`	The new owner ID
`{event_old_owner_id}`	The old owner ID

When AFK channel is set

Has the values about the server.Plus:

Value	What it is
`{event_afk_channel_id}`	The AFK channel ID
`{event_afk_timeout}`	How long before someone counts as AFK

When AFK channel is removed

Has the values about the server.Plus:

Value	What it is
`{event_afk_channel_id}`	The AFK channel ID

When guild banner is added

Has the values about the server.Plus:

Value	What it is
`{event_banner_url}`	A link to the banner picture

Other server events

When guild banner is removed, When guild becomes partnered, When guild partnership is removed and Guild Integrations Updated have the values about the server.

Invite events

When an invite is created

Has the values about the channel.Plus:

Value	What it is
`{event_invite_code}`	The invite code
`{event_invite_url}`	The invite link

When an invite is deleted

Has the values about the channel.Plus:

Value	What it is
`{event_invite_code}`	The invite code

Poll events

When a user votes on a poll, or removes their vote

Has the values about the person, the channel and the message.Plus:

Value	What it is
`{event_poll_answer}`	The answer they voted for

Scheduled event events

Created, updated or deleted

Has the values about the server.Plus:

Value	What it is
`{event_scheduled_event_id}`	The event ID
`{event_scheduled_event_name}`	The event name
`{event_scheduled_event_description}`	The event description

When a user joins or leaves a scheduled event

Has the values about the person and the server, plus the same three event_scheduled_event_ values.

Stage and sticker events

Stage Instance Created, Updated or Deleted

Has the values about the server and the channel.Plus:

Value	What it is
`{event_stage_id}`	The stage ID
`{event_stage_topic}`	The stage topic

Sticker Created, Updated or Deleted

Has the values about the server.Plus:

Value	What it is
`{event_sticker_id}`	The sticker ID
`{event_sticker_name}`	The sticker name
`{event_sticker_description}`	The sticker description
`{event_sticker_url}`	A link to the sticker picture

Auto Moderation and audit events

Auto Moderation Action Executed

Has the values about the person, the server, the channel and the message.Plus:

Value	What it is
`{event_action_type}`	What AutoMod did (block, alert or time out)
`{event_matched_content}`	The words that broke the rule
`{event_matched_keyword}`	The rule word it matched
`{event_rule_id}`	The rule ID
`{event_rule_trigger_type}`	What kind of rule it is

Auto Moderation Rule Created, Updated or Deleted

Has the values about the server.Plus:

Value	What it is
`{event_rule_id}`	The rule ID
`{event_rule_name}`	The rule name
`{event_rule_enabled}`	true if the rule is on
`{event_rule_trigger_type}`	What kind of rule it is

Audit Log Entry Created

Has the values about the person and the server.Plus:

Value	What it is
`{event_audit_action}`	What happened, in words
`{event_audit_action_type}`	The type of action
`{event_audit_executor_id}`	ID of who did it
`{event_audit_reason}`	The reason given
`{event_audit_target_id}`	ID of what it was done to
`{event_audit_target_type}`	What kind of thing it was done to

Application Command Permissions Updated

Has the values about the server.Plus:

Value	What it is
`{event_application_id}`	The app ID
`{event_command_id}`	The command ID

Bot events

When the bot starts or is restarted

Runs every time your bot turns on. Great for a Bot status block.

When the bot joins a server

Has the values about the server.Plus:

Value	What it is
`{event_guild_members}`	How many members the server has

When the bot leaves a server

Has the values about the server.

When a custom variable's value changes

Has the values about the server.Plus:

Value	What it is
`{event_variable_name}`	The variable that changed
`{event_variable_old_value}`	The old value
`{event_variable_new_value}`	The new value
`{event_variable_user_id}`	The member it changed for
`{event_variable_key}`	The key that changed

When the bot is updated through the dashboard

Value	What it is
`{event_update_type}`	What was changed

Timed events

The clock events (every 10 seconds, 1 minute, 5, 10 and 30 minutes, 1, 3, 6 and 12 hours, and every 24 hours) run by themselves. Nobody did anything, so there is no person and no channel. To say something, use Post in a channel with a channel ID.

When a timed event is executed

Runs when one of your own timed events fires. Gives {timed_event_name} and {timed_event_id}.

When a YouTube channel uploads a video

Choose the YouTube channel in Integrations. Gives {event_youtube_video_title}, {event_youtube_video_url}, {event_youtube_video_thumbnail}, {event_youtube_channel_title} and more. See YouTube, Twitch and TikTok alerts.

When a Twitch channel goes live

Choose the streamer in Integrations. Gives {event_twitch_display_name}, {event_twitch_stream_title}, {event_twitch_game_name}, {event_twitch_channel_url}, {event_twitch_viewer_count} and more.

When a TikTok account posts

Choose the account in Integrations. Gives {event_tiktok_display_name}, {event_tiktok_post_url}, {event_tiktok_post_description}, {event_tiktok_post_thumbnail} and more.

When a webhook is executed

Runs when another website sends data to your bot’s webhook link. Every field it sends becomes a {webhook_...} value: a field called amount becomes {webhook_amount}. See Inbound webhooks.

WhatsApp flows

WhatsApp flows use their own values, not event_ ones:

Value	What it is
`{wa_name}`	Their WhatsApp name
`{wa_from}`	Their phone number
`{wa_text}`	What their message says
`{wa_type}`	What they sent: text, image, audio, location and so on
`{wa_time}`	When it was sent
`{wa_message_id}`	The message ID
`{wa_reply_to}`	The message they replied to
`{wa_choice_id}`	The hidden ID of the button or choice they tapped
`{wa_choice_title}`	The words on the button or choice they tapped
`{wa_choice_description}`	The small text under the choice they tapped
`{wa_media_id}`	The ID of a picture, voice note or file they sent
`{wa_media_mime}`	What kind of file it is
`{wa_latitude}`	Latitude, when they share a location
`{wa_longitude}`	Longitude, when they share a location
`{wa_location_name}`	The place name, when they share a location
`{wa_bot_number}`	Your WhatsApp number

See WhatsApp variables.

Getting started

Build real systems

Building with blocks

Block library

Event triggers

Variables

Card Studio

WhatsApp bots

Connections

Your bot

Account and plans

Help and fixes

Every event

Member events

Message events

Reaction events

Voice events

Channel events

Thread events

Role events

Boost events

Server events

Invite events

Poll events

Scheduled event events

Stage and sticker events

Auto Moderation and audit events

Bot events

Timed events

WhatsApp flows

​Values many events share

​Every event

​Member events

​Message events

​Reaction events

​Voice events

​Channel events

​Thread events

​Role events

​Boost events

​Server events

​Invite events

​Poll events

​Scheduled event events

​Stage and sticker events

​Auto Moderation and audit events

​Bot events

​Timed events

​Social alerts and webhooks

​WhatsApp flows

Values many events share

Every event

Member events

Message events

Reaction events

Voice events

Channel events

Thread events

Role events

Boost events

Server events

Invite events

Poll events

Scheduled event events

Stage and sticker events

Auto Moderation and audit events

Bot events

Timed events

Social alerts and webhooks

WhatsApp flows