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

# Events

> Make your bot react to things that happen.

An **event** is something that happens on its own in your server. Your bot can **listen** for it and do something when it happens. DogeBot has **more than 100** events to pick from.

## Some examples

| When this happens | Your bot could... |
| - | - |
| Someone **joins** the server | Send a welcome card and give them a role. See [Welcome messages and cards](/build-real-systems/welcome-messages-and-cards). |
| Someone **leaves** | Say goodbye in a channel. |
| Someone **sends a message** | Give them XP. See [Levels and XP](/build-real-systems/levels-and-xp). |
| Someone **adds a reaction** | Give them a role. |
| A **timer** rings | Post a message. See [Timed events](/building-with-blocks/timed-events). |

## How to make an event

**1. Make a new event**

Press **Events** in the sidebar, then **New event**.

**2. Pick what it listens for**

The event list has groups down the side, starting with **All events**. Pick a group, or type in **Search events** to find one fast, like `join` or `message`.

![The event picker with groups and a search box](https://mintcdn.com/doge-bot/0C6-zgXTpDx1QOCe/images/guide/event-picker.png?fit=max\&auto=format\&n=0C6-zgXTpDx1QOCe\&q=85\&s=9a4a944abf5b2a65384e22c7f4386887)

**3. Add blocks**

The Event Builder opens. Add **Steps** and **Checks** under the first block and join them, just like a command. Events have no Inputs, because nobody types anything.

**4. Save and switch it on**

Press **Save**. Make sure the event is switched **on** in your Events list.

> **Example: say hello**
>
> Event: someone joins the server → **Post in a channel**: `Welcome {user_name}!`
>
> Sam joins. The bot posts: **Welcome Sam!**

See every event in [Event triggers](/event-triggers).

## Switching events on and off

Use the switch next to an event in the **Events** list or in the builder's side list. An event that is off shows **"Off, it won't run"** and does nothing until you switch it on again. It takes about **10 seconds** to take effect.

## Timed events

A **timed event** runs by itself on a clock, like every hour. See [Timed events](/building-with-blocks/timed-events).

## Things to know

> [!WARNING]
>
> * For **message** events, turn on the **Message Content Intent** in the Discord Developer Portal.
> * For **join and leave** events, turn on the **Server Members Intent**.
>
> See [Make a Discord bot](/getting-started/make-a-discord-bot).

Not working? Open [Error Logs](/your-bot/error-logs).


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