Notifications Guide

Learn how Streamlinx notifications work, when they're sent, and how to customize them for your Discord server.

How Notifications Work

Streamlinx performs real-time event detection across Twitch, YouTube, and Kick, so notifications arrive within seconds of a stream going live. Additional monitoring runs continuously to ensure no notifications are missed.

Notification Types

Live Notifications

Sent when a streamer goes live (starts streaming).

Content includes:

• Streamer name and avatar
• Stream title
• Game/category being played
• Direct link to stream
• Platform indicator (Twitch/YouTube/Kick)
• Current viewer count
• Role mention (if configured in the message template)

Offline Notifications

When a stream ends, Streamlinx gives you two independent controls:

Cleanup Action

Determines what happens to the original live notification:

Configure this in the Offline tab when editing a streamer.

Standalone Offline Notification

A separate message sent when the stream ends, independent of the cleanup action above. Enable this in the Offline tab.

When enabled, you can customize:

• Offline message template — uses its own template variables including {duration} and {vod_url}
• Button controls — independently show/hide the View Channel and View VOD buttons
• Hide viewer count — remove the last viewer count from the offline embed

You can use both features together. For example, edit the original live notification with "Show Offline" and send a standalone offline message — they work independently.

Update Notifications

Sent when a stream's title or game/category changes while live. The original notification is edited to reflect the new information.

Upload Notifications (YouTube)

Sent when a tracked YouTube channel uploads a new video. Enable per-streamer in the Content tab.

• Exclude YouTube Shorts — enabled by default, filters out videos 60 seconds or shorter

Clip Notifications (Twitch)

Sent when viewers create clips from a tracked streamer's broadcast. Enable per-streamer in the Content tab. Clips are detected automatically while the streamer is live.

Notification Channels

Per-Streamer Channel Routing

When you add a streamer, you choose which Discord channel receives their notifications. Each streamer can use a different channel:

• #twitch-streams — Twitch streamers
• #youtube-streams — YouTube streamers
• #vip-streamers — Your most important streamers

Content Notification Channel

Upload and clip notifications can be routed to a separate channel from live notifications. Configure this per-streamer in the Content tab. If not set, content notifications use the streamer's main notification channel.

Configuring Channels

Via Discord Bot:

/streamer add twitch username:shroud channel:#twitch-streams

Via Web Portal:

1. Login at streamlinx.io
2. Select your server
3. When adding a streamer, select the notification channel from the dropdown

Notification Pausing

Streamlinx automatically pauses notifications when it detects delivery issues:

• Channel deleted — If a notification channel is deleted from Discord, notifications for all streamers and live roles using that channel are paused. You'll receive a DM explaining what happened and how to fix it.
• Webhook deleted — If a webhook is deleted from Discord, notifications using that webhook are paused. You'll receive a DM with instructions to set up a new webhook or remove the configuration.
• Permission issues — If the bot is unable to send messages to a channel after 3 failed attempts, notifications to that channel are paused until the issue is resolved.

Paused notifications are clearly flagged in the portal with amber warning badges. Look for the warning indicators on the Streamers and Live Roles pages to find and fix delivery issues.

Custom Message Templates

Customize notification messages using template variables. Available for all users via the web portal. Discord markdown is supported for rich formatting.

Live Notification Variables

Offline Notification Variables

Upload Notification Variables (YouTube)

Clip Notification Variables (Twitch)

Role Mentions

You can mention Discord roles in any notification template. In the template editor, click the @Mention role button or type @ in the text area to open a role picker. The selected role is inserted as a chip in your template and will ping that role when the notification is sent.

This works for all notification types — live, offline, upload, and clip templates can each mention different roles, letting you target specific groups for each type of alert.

Template Tips

• Maximum 2000 characters (Discord limit)
• Must include at least {url} or {streamer}
• Discord markdown is supported (bold, italic, links, etc.)
• Use the live embed preview in the portal to see how your template will look before saving

Display Controls

Customize how notification embeds look per-streamer:

• Custom embed color — set a custom color for the embed sidebar (hex format, e.g., #FF5733). Defaults to platform colors: Twitch Purple, YouTube Red, Kick Green
• Hide duration — remove the duration field from upload/clip embeds
• Hide thumbnail — remove the thumbnail image from upload/clip embeds

Button Controls

Online and offline notifications have independent button visibility settings:

Online notifications:

• Watch Stream button — direct link to the live stream
• View Channel button — link to the streamer's channel page

Offline notifications:

• View Channel button — link to the streamer's channel page
• View VOD button — link to the stream recording (Twitch only)

Each button can be shown or hidden independently per-streamer in the Online and Offline tabs.

Custom Identity (Premium)

Make notifications appear with custom names and avatars instead of the default Streamlinx bot identity. Custom identity works at two levels, giving you flexible branding options.

Guild-Level Custom Webhook

Set a server-wide custom webhook in Server Settings → Advanced. All notifications in the server will use this identity unless overridden at the streamer level.

Use this for: Consistent server branding — e.g., your community's name and logo on every notification.

Streamer-Level Custom Webhook

Set a custom webhook on individual streamers in the Advanced tab of the streamer edit page. This overrides the guild-level webhook for that streamer only.

Use this for: Per-streamer branding — e.g., notifications that appear to come from each streamer with their name and avatar.

Webhook Name & Avatar Options

• Custom Name: Replace "Streamlinx" with any text
  • Use streamer name: {streamer} Stream Alert
  • Use server name: YourServer Streams
  • Static text: Live Now!
• Custom Avatar: Set a custom image
  • Use streamer avatar: {streamer_avatar}
  • Use server icon: {server_icon}
  • Custom image link: https://example.com/icon.png

Notification Cooldowns (Premium)

Prevent notification spam when streamers experience connection issues or restart their stream.

How it works:

1. When a notification is sent, a cooldown timer starts
2. During the cooldown period, no new notifications are sent for that streamer
3. After the cooldown expires, notifications resume normally

Configuration levels:

Cooldown range: 1 minute to 24 hours (1–1440 minutes)

Per-Type Cooldowns

Premium users can set independent cooldown timers for each notification type:

• Live notification cooldown — in the Advanced tab
• Upload notification cooldown — shown when upload notifications are enabled
• Clip notification cooldown — shown when clip notifications are enabled

Each cooldown operates independently — a live cooldown won't suppress upload or clip notifications, and vice versa.

Notification Filter Rules (Premium)

Control when notifications are sent based on stream content.

Filter types:

• Title Match: Filter based on stream title content
• Game/Category Match: Filter based on game or category

Match modes:

• Matches: Only send notification if the pattern is found
• Does Not Match: Only send notification if the pattern is NOT found

Examples:

• Only notify for "Tournament" streams → Title matches "Tournament"
• Skip "Just Chatting" notifications → Game does not match "Just Chatting"
• Only notify for specific games → Game matches "Valorant|League of Legends"

Limits: Up to 5 filter rules per streamer

Platform-Specific Behavior

All platforms share the same core notification features (live/offline/update notifications, viewer count, game/category). The key differences are detection speed and platform-specific features.

Twitch

Detection Speed: Near-instant (typically under 30 seconds)

Features:

• VOD link button in offline notifications (when available)
• Game box art thumbnails in embeds
• Clip notifications

Embed Color: Purple (#9146FF)

YouTube

Detection Speed: 2–5 minutes (YouTube platform limitation)

Features:

• Upload notifications for new videos
• Exclude YouTube Shorts filter
• Premieres are treated as live streams when they start

Limitations:

• No VOD links in offline notifications

Embed Color: Red (#FF0000)

Kick

Detection Speed: Near-instant (typically under 30 seconds)

Limitations:

• No VOD links (Kick doesn't make past broadcasts available)

Embed Color: Green (#53FC18)

Troubleshooting

Notifications Not Sending

1. Bot Permissions: Ensure bot has "Send Messages" and "Embed Links" in the notification channel
2. Channel Exists: Verify the notification channel hasn't been deleted
3. Streamer Status: Confirm the streamer is actually live (check the platform directly)
4. Webhook Permissions: If using custom identity, ensure "Manage Webhooks" permission is granted

Delayed Notifications

• YouTube notifications are inherently slower (2–5 minutes) due to platform limitations
• Twitch/Kick should arrive within seconds — if delayed, check the Streamlinx status page
• Platform outages on Twitch, YouTube, or Kick can cause delays

Duplicate Notifications

Streamlinx has built-in duplicate prevention. If you see duplicates:

• This is rare and usually self-corrects
• Setting a notification cooldown (Premium) prevents duplicates from connection issues
• If persistent, contact support

Best Practices

Organize by Channel

Use multiple notification channels to keep things organized:

#twitch-streams — Twitch streamers only
#youtube-streams — YouTube streamers only
#content-alerts — Uploads and clips
#vip-streamers — Your most important streamers

Keep Templates Clean

• Include essential info: streamer name, game, and link
• Use the live embed preview to test before saving
• Use emojis sparingly

Need Help?

• Check Troubleshooting for common issues
• Join Discord support server for help
• Email support: support@streamlinx.io
• Run /help in your Discord server