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

# YouTube notifications

> Announce new YouTube uploads and live streams in your Discord server.

<Info>
  Requires **Basic**. Up to **10 channels** per server. See [how notifications work](/en/notifications/overview) for the shared rules.
</Info>

## Adding a channel

Search by channel name. Vetox resolves it to a channel ID; an unresolvable channel is rejected with **YouTube channel not found**.

## Settings

| Setting                       | Default         | Notes        |
| ----------------------------- | --------------- | ------------ |
| **Discord Channel**           | —               | Required     |
| **Notify on upload**          | **On**          | New videos   |
| **Notify on live**            | **On**          | Live streams |
| **Mention Role**              | None            |              |
| **Custom Notification Embed** | YouTube default | Red          |

<Warning>
  Turning **both** toggles off saves without complaint and guarantees the channel never announces anything. There is no warning for this state.
</Warning>

## Variables

| Variable            | Resolves to                              |
| ------------------- | ---------------------------------------- |
| `{channel.name}`    | Channel name                             |
| `{channel.avatar}`  | Channel avatar                           |
| `{video.title}`     | Video title                              |
| `{video.url}`       | Video URL                                |
| `{video.thumbnail}` | Video thumbnail                          |
| `{video.type}`      | Whether it is an upload or a live stream |

## How new content is found

Checked every **5 minutes**, with a **10-minute cooldown** per channel. Vetox reads the channel's feed and considers the **5 most recent** entries each time.

<Note>
  A channel that publishes more than 5 videos inside one 5-minute window can have the oldest of them missed.
</Note>

<Warning>
  **A scheduled premiere is announced as an upload**, using the upload wording rather than the live wording. If your embed says "went live", a premiere will read incorrectly.
</Warning>

## Real-world setup

<Steps>
  <Step title="Turn YouTube on in Server Setup" />

  <Step title="Add the channel by name" />

  <Step title="Separate uploads from streams if you want different wording">
    You cannot route uploads and live streams to different Discord channels for the same YouTube channel — one channel per entry. Use `{video.type}` in the embed to distinguish them instead.
  </Step>

  <Step title="Check Embed Links in the target channel" />
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="A new video was not announced">
    Check the Server Setup toggle and premium first. Then confirm at least one of the two notify toggles is on. If the video is over 2 hours old, it is deliberately skipped.
  </Accordion>

  <Accordion title="A premiere announced as a normal upload">
    Expected — premieres are classified as uploads.
  </Accordion>

  <Accordion title="Shorts are announced and I do not want them">
    There is no filter to exclude Shorts. Everything on the channel's feed is treated the same.
  </Accordion>

  <Accordion title="Announcements are up to five minutes late">
    That is the poll interval. YouTube is checked every 5 minutes, not instantly.
  </Accordion>
</AccordionGroup>

<Card title="Twitch" icon="twitch" horizontal href="/en/notifications/twitch">
  Live streaming with instant state tracking.
</Card>