> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dogebot.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Server, scheduled, stage and sticker events

> These run when your server itself changes, and for scheduled events, stage channels and stickers.

These run when your server itself changes (its name, banner, owner and more), and for scheduled events, stage channels and stickers.

> **Example**
>
> Post a message when your server gets a new banner.

> [!NOTE]
>
> **How to use one:** go to **Events**, press **New Event**, pick the event from the list, then add blocks under it. In the list, Discord calls a server a **guild**, so these events use that word.

## Variables every event here has

| Type this | What you get |
| - | - |
| `{event_guild_id}` | The server ID |
| `{event_guild_name}` | The server name |

Some events also have the **person** variables: `{event_user_id}`, `{event_user_name}`, `{event_user_mention}`, `{event_user_avatar}`, `{event_user_tag}` and `{event_user_username}`.

## Server changes

> **When a guild member is updated**
>
> **When it runs:** someone's profile in the server changes.
>
> **Extra variables:** the person variables.

> **When guild features are updated**
>
> **When it runs:** your server's features change.
>
> **Extra variables:** `{event_old_features}`, `{event_new_features}`.

> **When guild ownership changes**
>
> **When it runs:** the server gets a new owner.
>
> **Extra variables:** `{event_old_owner_id}`, `{event_new_owner_id}`.
>
> **Build idea:** warn your staff in a log channel.

> **When guild becomes partnered / partnership is removed**
>
> **When it runs:** **When guild becomes partnered** runs when your server becomes a Discord partner. **When guild partnership is removed** runs when it stops.
>
> **Extra variables:** none.

> **When guild name changes**
>
> **When it runs:** the server is renamed.
>
> **Extra variables:** `{event_old_guild_name}`. The new name is `{event_guild_name}`.
>
> **Build idea:** post "We are now called `{event_guild_name}`!"

> **When AFK channel is set / removed**
>
> **When AFK channel is set** has `{event_afk_channel_id}` and `{event_afk_timeout}` (how long before someone counts as away).
>
> **When AFK channel is removed** has `{event_afk_channel_id}`.

> **When guild banner is added / removed**
>
> **When guild banner is added** has `{event_banner_url}` (a link to the banner).
>
> **When guild banner is removed** has no extras.
>
> **Build idea:** show off the new banner in your announcements channel.

> **Guild Integrations Updated**
>
> **When it runs:** the server's integrations change.
>
> **Extra variables:** none.

## Scheduled events

Scheduled events are the events you plan in Discord, with a time and a place.

> **When a scheduled event is created, updated or deleted**
>
> Three events: **When a scheduled event is created**, **When a scheduled event is updated** and **When a scheduled event is deleted**.
>
> | Type this | What you get |
> | - | - |
> | `{event_scheduled_event_id}` | The event ID |
> | `{event_scheduled_event_name}` | The event name |
> | `{event_scheduled_event_description}` | The event description |
>
> **Build idea:** announce every new server event in your chat.

> **When a user joins or leaves a scheduled event**
>
> **When a user joins a scheduled event** runs when someone presses **Interested**. **When a user leaves a scheduled event** runs when they take it back.
>
> **Variables:** the same three as above, plus the person variables.
>
> **Build idea:** DM people a reminder when they say they are interested.

## Stage events

> **Stage Instance Created, Updated or Deleted**
>
> **Stage Instance Created** runs when a stage goes live. **Stage Instance Updated** runs when it changes. **Stage Instance Deleted** runs when a stage ends.
>
> | Type this | What you get |
> | - | - |
> | `{event_stage_id}` | The stage ID |
> | `{event_stage_topic}` | The stage topic |
> | `{event_channel_id}` | The channel ID |
>
> **Build idea:** ping everyone when a stage talk starts.

## Sticker events

> **Sticker Created, Updated or Deleted**
>
> Three events: **Sticker Created**, **Sticker Updated** and **Sticker Deleted**.
>
> | Type this | What you get |
> | - | - |
> | `{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 |
>
> **Build idea:** show off new stickers in your chat.

## Example

Under **When guild banner is added**, a message block says:

```text theme={null}
We have a new banner! {event_banner_url}
```

The bot shows the message with the link to the new banner.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.