> ## 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.

# Role, boost and invite events

> These run when roles change, when someone boosts your server, or when invite links are made or removed.

These run when roles change, when someone boosts your server, or when invite links are made or removed.

> **Example**
>
> Thank someone in public when they boost your server.

> [!NOTE]
>
> **How to use one:** go to **Events**, press **New Event**, pick the event from the list, then add blocks under it.

## Variables many of these events share

**About the person**

| Type this | What you get |
| - | - |
| `{event_user_avatar}` | A link to their profile picture |
| `{event_user_id}` | Their ID |
| `{event_user_mention}` | Pings them |
| `{event_user_name}` | Their username |
| `{event_user_tag}` | Their full tag |
| `{event_user_username}` | Their username |

**About the server**

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

## Boost events

> **When a member boosts the server for the first time**
>
> **When it runs:** someone boosts your server.
>
> **Variables:** the person and server variables.
>
> **Build idea:** a big public thank you, and a special booster role.

> **When a member unboosts the server**
>
> **When it runs:** someone stops boosting.
>
> **Variables:** the person and server variables.

> **When the server boost level increases**
>
> **When it runs:** your server reaches a higher boost level.
>
> **Variables:** the server variables. Plus:
>
> | Type this | What you get |
> | - | - |
> | `{event_boost_level}` | The new boost level (0 to 3) |
>
> **Build idea:** announce "We reached level `{event_boost_level}`!"

> **When the server boost level decreases**
>
> **When it runs:** your server drops to a lower boost level.
>
> **Variables:** the server variables, plus `{event_boost_level}`.

## Invite events

> **When an invite is created**
>
> **When it runs:** someone makes an invite link.
>
> | Type this | What you get |
> | - | - |
> | `{event_channel_id}` | The channel the invite is for |
> | `{event_invite_code}` | The invite code |
> | `{event_invite_url}` | The invite link |
>
> **Build idea:** log every new invite link for your staff.

> **When an invite is deleted**
>
> **When it runs:** an invite link is removed.
>
> | Type this | What you get |
> | - | - |
> | `{event_channel_id}` | The channel the invite was for |
> | `{event_invite_code}` | The invite code |

## Role events

> **When a role is created**
>
> **When it runs:** a new role is made in your server.
>
> **Variables:** the server variables. Plus:
>
> | Type this | What you get |
> | - | - |
> | `{event_role_id}` | The role ID |
> | `{event_role_name}` | The role name |

> **When a role is updated**
>
> **When it runs:** a role is changed, for example renamed.
>
> **Variables:** the server variables. Plus:
>
> | Type this | What you get |
> | - | - |
> | `{event_old_role_name}` | The old role name |
> | `{event_role_id}` | The role ID |
> | `{event_role_name}` | The role name now |

> **When a role is deleted**
>
> **When it runs:** a role is removed from your server.
>
> **Variables:** the server variables, plus `{event_role_id}` and `{event_role_name}`.
>
> **Build idea:** warn your staff in a log channel.

> [!NOTE]
>
> Looking for when someone **gets** a role? That's on [Member events](/event-triggers/member-events): **When a role is added to a user**.

## Example

Under **When a member boosts the server for the first time**, a message block says:

```text theme={null}
Thank you {event_user_mention} for boosting {event_guild_name}!
```

The bot shows: **Thank you @Sam for boosting Doge Town!**


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