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

# Reddit notifications

> Announce new posts from any subreddit in your Discord server.

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

## Adding a subreddit

Enter the name without `r/`. Vetox verifies it exists; an unresolvable name is rejected with **Subreddit not found**.

Names are 1–50 characters: letters, numbers and underscores.

## Settings

| Setting                       | Default        | Notes    |
| ----------------------------- | -------------- | -------- |
| **Discord Channel**           | —              | Required |
| **Notify on New Posts**       | **On**         |          |
| **Mention Role**              | None           |          |
| **Custom Notification Embed** | Reddit default | Orange   |

## Variables

| Variable           | Resolves to       |
| ------------------ | ----------------- |
| `{post.title}`     | Post title        |
| `{post.url}`       | Link to the post  |
| `{post.author}`    | Poster's username |
| `{post.content}`   | The post body     |
| `{post.flair}`     | The post's flair  |
| `{post.thumbnail}` | Thumbnail image   |
| `{subreddit.name}` | Subreddit name    |
| `{subreddit.url}`  | Subreddit URL     |
| `{subreddit.icon}` | Subreddit icon    |

## How new posts are found

Checked every **3 minutes** with a **2-minute cooldown** per subreddit, reading the newest posts.

<Warning>
  **There is no filtering of any kind.** No sort selection, no flair filter, no minimum score, no NSFW filter, and no way to exclude stickied posts. Every new post in the subreddit is announced.

  On a busy subreddit this is a lot of messages. Track small or low-traffic subreddits, or be prepared for the volume.
</Warning>

<Tip>
  Give Reddit notifications their own channel rather than mixing them into general chat. It is by far the highest-volume platform of the eight.
</Tip>

### When Reddit rate-limits Vetox

If Reddit's API refuses requests, Vetox falls back to reading the subreddit's public feed for a few minutes.

<Note>
  On the fallback path, `{post.flair}`, `{post.thumbnail}` and `{post.content}` have no value, so fields built from them disappear. This is temporary and resolves itself.

  If your Reddit embeds occasionally arrive with fewer fields than usual, this is why.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Too many announcements">
    There is no filter. Pick a quieter subreddit, or remove it — this cannot be tuned.
  </Accordion>

  <Accordion title="Some announcements are missing fields">
    Reddit briefly rate-limited Vetox and the fallback path does not carry flair, thumbnail or body text.
  </Accordion>

  <Accordion title="NSFW posts are being announced">
    There is no NSFW filter. Do not track subreddits whose content you would not want posted.
  </Accordion>

  <Accordion title="Nothing at all is arriving">
    Server Setup's Reddit toggle, premium, and Embed Links in the channel.
  </Accordion>
</AccordionGroup>

<Card title="Bluesky" icon="cloud" horizontal href="/en/notifications/bluesky">
  Social posts with reply and repost filtering.
</Card>
