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

# YouTube

> Get notified in Discord whenever a channel uploads a new video.

# YouTube

> Get notified in Discord whenever a channel uploads a new video.

## How it works

raze polls YouTube channels every 2 minutes using their public RSS feed — no API key required. When a new video is detected, an embed is posted to the channel you configured. YouTube Shorts are automatically filtered out.

## Subscribe to a channel

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;youtube add (#channel) (@handle or channel URL)
  ```

  ```bash Example theme={null} theme={null}
  ;youtube add #uploads MrBeast
    ;youtube add #uploads @mkbhd
    ;youtube add #uploads https://youtube.com/@linus
  ```
</CodeGroup>

You can pass a handle, `@handle`, a `/channel/UC...` URL, or a raw channel ID.

## Unsubscribe

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;youtube remove (#channel) (@handle)
  ```

  ```bash Example theme={null} theme={null}
  ;youtube remove #uploads MrBeast
  ```
</CodeGroup>

## Custom notification message

Send a custom message alongside the embed when a new video drops.

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;youtube message (@handle) (message) [--pingable on|off]
  ```

  ```bash Example theme={null} theme={null}
  ;youtube message MrBeast @everyone new video just dropped!
    ;youtube message mkbhd @Tech new video! --pingable on
  ```
</CodeGroup>

The `--pingable` flag controls whether the message can ping roles and users. Defaults to off.

## List feeds

```bash theme={null} theme={null}
;youtube list
```

## Aliases

`;yt` is an alias for `;youtube`.

```bash theme={null} theme={null}
;yt add #uploads MrBeast
```

<Note>
  Shorts are automatically skipped — only regular videos trigger notifications.
</Note>