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

# YouTube Notifier

> Automatically announce new YouTube uploads in your server.

The **YouTube Notifier** module allows your server to track up to **5 YouTube channels**. Whenever one of the tracked channels uploads a new video, ZEON will automatically post a beautiful notification directly into your chosen Discord channel.

<Note>
  **Required Permission:** [Admin Access](/permissions/admin-access) or higher — Server Owner, Extra Owner, Trusted User, or Administrator with a role above the bot can use these commands.
</Note>

<Warning>
  **Premium Feature:** This module requires an active Premium subscription. If the server's premium expires, the YouTube Notifier system will be automatically disabled.
</Warning>

***

## Adding a Channel

To start tracking a YouTube channel, use the `.notifier add` command. You can provide the channel's URL, `@handle`, or direct channel ID.

| Command                         | Description                                                                                              |
| :------------------------------ | :------------------------------------------------------------------------------------------------------- |
| `.notifier add <url> <channel>` | Starts tracking the specified YouTube channel and sends its new uploads to the selected Discord channel. |

<Warning>
  **Tracking Limit:** There is a strict limit of **5 tracked YouTube channels** per server. If you reach this limit, you must use `.notifier remove` to delete an old channel before adding a new one.
</Warning>

<Note>
  Due to infrastructure caching and API limits, it can take up to **12 minutes** for ZEON to detect and announce a newly uploaded video. The bot checks for new videos every **2 minutes**, while the YouTube data fetcher securely caches results for **10 minutes** to prevent rate-limiting.
</Note>

***

## Customizing Announcements

By default, ZEON uses a standard message when announcing new videos. You can customize this message for each individual YouTube channel you track.

| Command                                | Description                                                                                           |
| :------------------------------------- | :---------------------------------------------------------------------------------------------------- |
| `.notifier message <target> <message>` | Sets a custom announcement message for the specified YouTube channel.                                 |
| `.notifier message <target>`           | If you run this without providing a message, it will reset the announcement back to the default text. |

### Available Variables

When creating a custom message, you can use the following variables to dynamically insert information about the video:

* `{channel}` - The name of the YouTube channel.
* `{title}` - The title of the newly uploaded video.
* `{url}` - The direct link to the video.

***

## Managing Notifications

You can easily update where notifications are sent, test your setup, or remove channels you no longer want to track.

| Command                                | Description                                                                            |
| :------------------------------------- | :------------------------------------------------------------------------------------- |
| `.notifier channel <target> <channel>` | Changes the Discord channel where the YouTube notifications are sent.                  |
| `.notifier remove <target>`            | Stops tracking the specified YouTube channel.                                          |
| `.notifier test <target>`              | Sends a test notification to ensure your channel and message are configured correctly. |

<Tip>
  When using commands like `message`, `channel`, or `remove`, ZEON provides a fast **Auto-Complete** dropdown menu so you don't have to type the full YouTube channel name manually.
</Tip>

***

## General Configuration

| Command             | Description                                                                                                                        |
| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------- |
| `.notifier show`    | Displays your active configuration, showing how many channels you are tracking (up to 5) and where their notifications are routed. |
| `.notifier disable` | Temporarily pauses all YouTube notifications without deleting your setup.                                                          |
| `.notifier enable`  | Resumes paused YouTube notifications.                                                                                              |
| `.notifier reset`   | Permanently deletes your entire YouTube Notifier configuration.                                                                    |