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

# Logging

> Log server events to dedicated channels via webhooks.

# Logging

> Log server events to dedicated channels via webhooks.

## Overview

Logging lets you track server events by sending embed messages to channels of your choice. Logs are delivered through webhooks so they appear clean and separate from regular bot responses. You can log specific events, entire categories, or everything at once using the interactive setup panel or manual CLI commands.

## Interactive Setup & Customization UI

Launch an interactive setup dashboard directly in Discord using `;logs panel`, `;logs setup`, or `;logging`. The interactive UI allows you to select main categories, customize channels via modal dropdowns, navigate pages, and review active configurations.

<CodeGroup>
  ```bash Command theme={null} theme={null}
  ;logs panel
  ```

  ```bash Aliases theme={null} theme={null}
  ;logs setup
  ;logging
  ;logpanel
  ```
</CodeGroup>

### Features:

* **Category Multi-Select**: Pick one or multiple logging categories at once (Messages, Channels & Threads, Voice & Stages, Members & Moderation, Roles, Server Settings, Emojis, Stickers, Scheduled Events, AutoMod, Integrations & Webhooks, Invites, Soundboard).
* **Sub-Event Modal Channel Picker**: Select channels dynamically using Discord channel dropdowns within pop-up modals.
* **"All Events" Shortcut**: Assign a single channel to all sub-events in a category with one click.
* **Configure Dashboard**: Inspect all currently mapped event channels grouped cleanly by category.
* **Action Paginator Navigation**: Easily jump between category pages using previous (`<`), next (`>`), and page jump (`↑1/9`) buttons.

***

## Adding log channels manually

<Tabs>
  <Tab title="Single event">
    Log a specific event to a channel.

    <CodeGroup>
      ```bash Syntax theme={null} theme={null}
      ;logs add (event) (channel)
      ```

      ```bash Example theme={null} theme={null}
      ;logs add message_delete #message-logs
      ;logs add automod_execution #automod-logs
      ;logs add member_join #member-logs
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Event group">
    Log an entire group of events to one channel.

    <CodeGroup>
      ```bash Syntax theme={null} theme={null}
      ;logs add (group) (channel)
      ```

      ```bash Example theme={null} theme={null}
      ;logs add messages #message-logs
      ;logs add members #member-logs
      ;logs add server #server-logs
      ```
    </CodeGroup>

    **Valid groups:** `messages`, `channels`, `voice`, `members`, `roles`, `server`, `emojis`, `stickers`, `events`, `automod`, `integrations`, `invites`, `soundboard`
  </Tab>

  <Tab title="All events">
    Send every event to one single channel.

    <CodeGroup>
      ```bash Syntax theme={null} theme={null}
      ;logs add all (channel)
      ```

      ```bash Example theme={null} theme={null}
      ;logs add all #server-logs
      ```
    </CodeGroup>
  </Tab>
</Tabs>

***

## Event reference

<AccordionGroup>
  <Accordion title="Messages" icon="message">
    **Group Alias:** `messages` (or `message`, `msg`)\
    **Default Auto-Setup Channel:** `#message-logs`

    **Events Included:**

    * `message_delete` — Triggered when a message is deleted.
    * `message_edit` — Triggered when a message is edited.
    * `message_bulk_delete` — Triggered when messages are bulk purged.
    * `message_pin` — Triggered when a message is pinned or unpinned.
    * `reaction_add` — Triggered when a user adds a reaction to a message.
    * `reaction_remove` — Triggered when a user removes a reaction from a message.
    * `reaction_clear` — Triggered when all reactions are cleared from a message.
  </Accordion>

  <Accordion title="Channels & Threads" icon="hashtag">
    **Group Alias:** `channels` (or `channel`)\
    **Default Auto-Setup Channel:** `#channel-logs`

    **Events Included:**

    * `channel_create` — Triggered when a text, voice, or category channel is created.
    * `channel_delete` — Triggered when a channel is deleted.
    * `channel_update` — Triggered when channel name, topic, or permissions are modified.
    * `thread_create` — Triggered when a public or private thread is created.
    * `thread_delete` — Triggered when a thread is deleted.
    * `thread_update` — Triggered when thread name, archived state, or lock status changes.
  </Accordion>

  <Accordion title="Voice & Stages" icon="microphone">
    **Group Alias:** `voice`\
    **Default Auto-Setup Channel:** `#voice-logs`

    **Events Included:**

    * `voice_join` — Triggered when a user connects to a voice channel.
    * `voice_leave` — Triggered when a user disconnects from a voice channel.
    * `voice_move` — Triggered when a user moves between voice channels.
    * `voice_mute` — Triggered when a user is server muted or deafened in voice.
    * `voice_stream` — Triggered when a user starts or stops screen sharing / video.
    * `stage_instance_create` — Triggered when a stage topic/instance starts.
    * `stage_instance_delete` — Triggered when a stage instance ends.
  </Accordion>

  <Accordion title="Members & Moderation" icon="user-shield">
    **Group Alias:** `members` (or `member`, `moderation`, `mod`)\
    **Default Auto-Setup Channel:** `#member-logs`

    **Events Included:**

    * `member_join` — Triggered when a user joins the server.
    * `member_leave` — Triggered when a user leaves or is kicked from the server.
    * `member_ban` — Triggered when a member is banned from the server.
    * `member_unban` — Triggered when a user is unbanned.
    * `member_update` — Triggered when a member updates nickname, avatar, or profile.
    * `member_roles_update` — Triggered when roles are granted to or removed from a member.
    * `member_timeout` — Triggered when a member is timed out or timeout is removed.
  </Accordion>

  <Accordion title="Roles" icon="shield">
    **Group Alias:** `roles` (or `role`)\
    **Default Auto-Setup Channel:** `#role-logs`

    **Events Included:**

    * `role_create` — Triggered when a new server role is created.
    * `role_delete` — Triggered when a server role is deleted.
    * `role_update` — Triggered when role name, color, or permissions are modified.
  </Accordion>

  <Accordion title="Server Settings" icon="sliders">
    **Group Alias:** `server` (or `guild`)\
    **Default Auto-Setup Channel:** `#server-logs`

    **Events Included:**

    * `guild_update` — Triggered when server name, description, or main settings change.
    * `guild_icon_update` — Triggered when server icon is changed.
    * `guild_banner_update` — Triggered when server banner image is updated.
    * `guild_splash_update` — Triggered when invite splash is changed.
    * `guild_discovery_update` — Triggered when discovery settings are modified.
    * `guild_vanity_update` — Triggered when server vanity URL code is changed.
    * `guild_boost_add` — Triggered when a member boosts the server.
    * `guild_boost_remove` — Triggered when a boost expires or is removed.
    * `guild_boost_tier_update` — Triggered when server boost level changes.
    * `guild_widget_update` — Triggered when server widget settings change.
    * `guild_afk_channel_update` — Triggered when AFK channel or timeout is changed.
    * `guild_system_channel_update` — Triggered when system messages channel changes.
    * `guild_safety_alerts_update` — Triggered when safety alerts channel changes.
    * `guild_verification_level_update` — Triggered when server verification level changes.
    * `guild_explicit_content_filter_update` — Triggered when explicit content filter changes.
    * `guild_default_notifications_update` — Triggered when default notification level changes.
  </Accordion>

  <Accordion title="Emojis" icon="face-smile">
    **Group Alias:** `emojis` (or `emoji`)\
    **Default Auto-Setup Channel:** `#emoji-logs`

    **Events Included:**

    * `emoji_create` — Triggered when a new custom emoji is added.
    * `emoji_delete` — Triggered when a custom emoji is deleted.
    * `emoji_update` — Triggered when an emoji name is modified.
  </Accordion>

  <Accordion title="Stickers" icon="note-sticky">
    **Group Alias:** `stickers` (or `sticker`)\
    **Default Auto-Setup Channel:** `#sticker-logs`

    **Events Included:**

    * `sticker_create` — Triggered when a new custom sticker is created.
    * `sticker_delete` — Triggered when a sticker is deleted.
    * `sticker_update` — Triggered when sticker details are updated.
  </Accordion>

  <Accordion title="Scheduled Events" icon="calendar">
    **Group Alias:** `events` (or `event`)\
    **Default Auto-Setup Channel:** `#event-logs`

    **Events Included:**

    * `scheduled_event_create` — Triggered when a scheduled event is created.
    * `scheduled_event_delete` — Triggered when a scheduled event is cancelled/deleted.
    * `scheduled_event_update` — Triggered when scheduled event details change.
    * `scheduled_event_user_add` — Triggered when a user subscribes to an event.
    * `scheduled_event_user_remove` — Triggered when a user unsubscribes from an event.
  </Accordion>

  <Accordion title="AutoMod" icon="robot">
    **Group Alias:** `automod`\
    **Default Auto-Setup Channel:** `#automod-logs`

    **Events Included:**

    * `automod_rule_create` — Triggered when a new AutoMod rule is created.
    * `automod_rule_delete` — Triggered when an AutoMod rule is deleted.
    * `automod_rule_update` — Triggered when an AutoMod rule is updated.
    * `automod_execution` — Triggered when AutoMod blocks a message or flags a member violation.
  </Accordion>

  <Accordion title="Integrations & Webhooks" icon="webhook">
    **Group Alias:** `integrations` (or `webhook`)\
    **Default Auto-Setup Channel:** `#integration-logs`

    **Events Included:**

    * `webhook_create` — Triggered when a channel webhook is created.
    * `webhook_delete` — Triggered when a webhook is removed.
    * `webhook_update` — Triggered when webhook name or channel changes.
    * `integration_create` — Triggered when a bot or integration is added.
    * `integration_delete` — Triggered when an integration is removed.
    * `integration_update` — Triggered when integration settings update.
  </Accordion>

  <Accordion title="Invites" icon="envelope">
    **Group Alias:** `invites` (or `invite`)\
    **Default Auto-Setup Channel:** `#invite-logs`

    **Events Included:**

    * `invite_create` — Triggered when an invite link is created.
    * `invite_delete` — Triggered when an invite link expires or is deleted.
  </Accordion>

  <Accordion title="Soundboard" icon="music">
    **Group Alias:** `soundboard`\
    **Default Auto-Setup Channel:** `#soundboard-logs`

    **Events Included:**

    * `soundboard_sound_create` — Triggered when a soundboard sound is uploaded.
    * `soundboard_sound_delete` — Triggered when a soundboard sound is deleted.
    * `soundboard_sound_update` — Triggered when a soundboard sound name/emoji updates.
  </Accordion>
</AccordionGroup>

***

## Removing Logging Configuration

Remove configured logging channels interactively or by command.

<Tabs>
  <Tab title="Interactive Reset">
    Click the **Reset** button in `;logs panel` to open the category reset menu.

    * Select **Reset All Categories** or check specific categories.
    * Confirm the reset via the interactive **Confirm Reset** button.
  </Tab>

  <Tab title="Command Removal">
    Remove specific events, event groups, or stop logging all events using commands.

    <CodeGroup>
      ```bash Remove Specific Event/Group theme={null} theme={null}
      ;logs remove messages
      ;logs remove voice
      ;logs remove member_join
      ```

      ```bash Remove All Log Settings theme={null} theme={null}
      ;logs remove all
      ```
    </CodeGroup>
  </Tab>
</Tabs>

***

## Ignore list

Stop specific users, roles, or channels from generating log entries.

<Tabs>
  <Tab title="Add to ignore">
    <CodeGroup>
      ```bash Syntax theme={null} theme={null}
      ;logs ignore add (user/role/channel)
      ```

      ```bash Example theme={null} theme={null}
      ;logs ignore add @wanderer
      ;logs ignore add #bot-commands
      ;logs ignore add @Moderator
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Remove from ignore">
    <CodeGroup>
      ```bash Syntax theme={null} theme={null}
      ;logs ignore remove (user/role/channel)
      ```

      ```bash Example theme={null} theme={null}
      ;logs ignore remove @wanderer
      ;logs ignore remove #bot-commands
      ```
    </CodeGroup>
  </Tab>

  <Tab title="View ignore list">
    <CodeGroup>
      ```bash Syntax theme={null} theme={null}
      ;logs ignore list
      ```

      ```bash Example theme={null} theme={null}
      ;logs ignore list
      ```
    </CodeGroup>
  </Tab>
</Tabs>

***

## View configured log channels

List all active logging event channels.

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;logs list
  ```

  ```bash Example theme={null} theme={null}
  ;logs list
  ```
</CodeGroup>