Each feed watches one source and posts new items to a channel.
1. Turn on Social Feeds
Open the dashboard, pick the server, then switch on the Social & Patches card on the Services page.
Permissions you and the bot need
The bot needs View Channel, Send Messages and Embed Links in each channel a feed posts to. Some options need more:
| For | The bot also needs |
|---|---|
| A channel with Twitch or Kick feeds | Read Message History |
| Posting as a webhook | Manage Webhooks |
| "Allow @everyone and @here" | Mention @everyone, @here and All Roles |
| A live role | Manage Roles |
Adding or changing feeds needs Edit on Social & Patches in your dashboard role. Owners have it. Managers have it by default.
Optional: let Setup make the channels
The service's pages have three tabs: Overview, New Feed and Setup.
- On Setup, "Create / repair channels" makes a "📡 Social Alerts" category with #patches, #streams and #creator-posts (everyone can read, only the bot can post). Running it again keeps existing channels.
- Starter packs, also on Setup, add a bundle of popular feeds to a channel you pick, with an optional ping role.
- Running a starter pack again on the same channel puts those feeds' name, icon, message text and poll interval back to the defaults and switches them back on. Their keyword filters are kept.
2. Add a feed
Open New Feed and pick a tile. Game Patch Catalog lets you pick several games at once for one channel, and All sources has one tile per kind of feed.
What each feed needs
The catalog covers CS2, LoL, Valorant, Apex, Fortnite, Minecraft and more. The main sources need:
- Twitch Streamer: the Twitch username, "The streamer's login name (e.g. 'ninja')".
- Kick Streamer: the Kick channel, "The channel name from the kick.com URL (e.g. 'xqc')".
- YouTube Channel: "Channel ID (UC...), @handle (for example @AMD) or a youtube.com channel URL." A handle or URL is resolved when you save.
- Generic RSS / Atom: the feed URL, "Any RSS 2.0 or Atom feed (https://...)".
Other tiles cover Bluesky accounts, Steam games by App ID, GitHub releases, Reddit feeds and service status pages. Each form also takes a display name (shown in the notification) and an optional icon URL.
Greyed-out Twitch or Kick tiles
Twitch and Kick alerts need app credentials on the platform. When they are missing, that tile is greyed out and cannot be clicked, and a notice above the tiles says so. For Kick it reads "Kick alerts need Kick app credentials on the bot. Ask the platform owner to add them."
The hosted bot has no Kick app credentials, so Kick alerts do not work on it. See Troubleshooting.
3. Set up stream alerts
Optional: for Twitch and Kick, fill in the Stream options that the form adds.
Stream options
- "When the stream ends": keep the alert, edit it with the duration, viewers and VOD link, delete it or post a short offline message. The VOD link is added for Twitch streams only.
- "Live refresh (seconds)": updates the title, game and viewer count while live (minimum 120).
- "Only alert for these games": a game filter.
- "Live role": given to the streamer's member account while the stream is live.
4. Choose the destination
Under Destination, pick a text channel, an announcement channel or a forum, then choose who it pings.
Forums and announcement channels
- A forum gets one new post per item, with optional forum tags.
- In an announcement channel, "Publish to followers" publishes each post the bot makes. Posts made as a webhook and Test posts are not published.
- Discord allows 10 publishes per hour per channel. Over that, the item still posts and only the publish is skipped.
Pings
- "Ping roles (optional)" pings the roles you pick through
{role_mention}(or{mentions}) in the message text, which the default text has. - A role is pinged only when it is mentionable or the bot has Mention @everyone, @here and All Roles.
- "Allow @everyone and @here" is off by default. When it is on,
{role_mention}adds @everyone, so every item pings the whole server.
Posting as a webhook
"Post as" is the bot, or a webhook with its own name and avatar. One webhook named YourBot Feeds is created per channel and shared by its feeds.
5. Write the message
Leave "Message text (optional)" blank to use the source default, check the preview and click Create Subscription. Nothing is sent until you save.
Message text and placeholders
"Message text (optional)" is a template. Blank uses the source default, for example "{role_mention} 🔴 {display_name} is live" for Twitch and only the pings for most other sources. The Discord preview updates as you type.
Placeholders: {title}, {url}, {body}, {display_name}, {source}, {author}, {game}, {viewers}, {published_at}, {role_mention} (or {mentions}) and {thumbnail}. A name in braces that is not a placeholder is posted as written.
The embed
"Send an embed" is on by default. You can set the colour (blank uses the source colour), a title prefix and footer text. You also choose whether to show the feed name above the title, the item text, the feed icon and the item image.
With the embed off, put {title} and {url} in the text so members still get the link.
Keyword filters
Two keyword filters, "Only post if it mentions" and "Never post if it mentions", are comma-separated and ignore case. Both search the title, the item text and the link. An exclude match always wins.
6. Choose how often it checks
Optional: change the Poll interval (seconds) or turn on a Digest.
Poll interval: defaults and limits
Every feed has a "Poll interval (seconds)". Defaults and minimums come from the source:
| Source | Default | Minimum |
|---|---|---|
| Twitch and Kick | every 120 seconds | 60 seconds |
| YouTube and RSS | every 900 seconds | 120 seconds |
The maximum for any feed is 86400 (24 hours).
When checks run
- The bot looks for due feeds every 30 seconds, so a check can run up to half a minute after its time.
- Each platform has a shared request budget: when a source is busy, the check is tried again 45 seconds later.
- Reddit gets one request a minute shared by every Reddit feed on every server, so Reddit feeds can run late.
- A new feed does not post its backlog: the first check marks the newest item as seen, and posting starts with the next new item.
- The Overview tile shows "every Ns" and the last "posted" time or "nothing posted yet". While the feed is on, it also shows the "next poll" time.
Digest
The "Digest" choices are "Off, post every item", "Every 15 minutes", "Every hour", "Every 6 hours" and "Every 24 hours".
- With a digest, items are collected and posted together as one message. That message lists the newest 25 items and counts the rest.
- A feed holds at most its newest 200 items between two digests.
7. Test it
On the Overview, press Test (posts for real). It fetches the newest item that passes the feed's keyword filters and posts it to the channel right away.
If the filters block every item
When the filters block every recent item, Test answers "All {n} recent items were blocked by this feed's keyword filters. Nothing to post."
The History list
"History" lists the feed's last 100 items, Test posts included, each with an "Open in Discord" link or "not posted". Items older than 90 days drop off the list.
8. Pause, reset or remove a feed
On the Overview tile, use Enable, Disable, Delete or, when the feed is off or failing, Reset.
What each button does
- Enable or Disable: a disabled feed is not checked, and enabling it puts it back on the next pass.
- Delete asks "Delete this subscription?".
- Skip to current: the next check marks the newest item as seen without posting, which stops a backlog flood.
- Reset ("Clear failures + re-enable") shows when the feed is off or failing.
When a feed switches itself off
After 5 failed checks in a row a feed switches itself off and shows its last error on the tile. The server's owner and managers get a dashboard notification.
Fix the cause, usually the channel or the bot's permissions, then press Reset. More fixes are on the troubleshooting page.
9. Know the feed limit
A server can hold 100 feeds.
What counts
- Every feed counts, on or off, across every source.
- A catalog or starter pack add counts each new feed.
- Adding a feed that already posts to that channel updates it instead and does not count again.
- Past the cap, adding one is refused with a message that gives the limit (100) and how many feeds the server already has.