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

# Reddit

> Get notified in Discord when new posts appear in a subreddit.

# Reddit

> Get notified in Discord when new posts appear in a subreddit.

## How it works

raze polls subreddits every 5 minutes using Reddit's public JSON API. When new posts appear since the last check, up to 3 are posted as embeds — oldest first to preserve chronological order.

## Subscribe to a subreddit

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;reddit add (#channel) (subreddit)
  ```

  ```bash Example theme={null} theme={null}
  ;reddit add #art r/DigitalArt
    ;reddit add #news worldnews
  ```
</CodeGroup>

The `r/` prefix is optional.

## Unsubscribe

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;reddit remove (#channel) (subreddit)
  ```

  ```bash Example theme={null} theme={null}
  ;reddit remove #art DigitalArt
  ```
</CodeGroup>

## Custom notification message

Send a custom message alongside each post embed.

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

  ```bash Example theme={null} theme={null}
  ;reddit message worldnews @News new post!
    ;reddit message DigitalArt @Art check this out! --pingable on
  ```
</CodeGroup>

## List feeds

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

<Note>
  Private and banned subreddits cannot be subscribed to. raze validates the subreddit exists before saving it.
</Note>