Live Roles

What Are Live Roles?

Live Roles automatically detect when members of your Discord server go live on Twitch and assign them a special role. When they stop streaming, the role is automatically removed.

Use Cases:

• Highlight members who are currently streaming
• Give streamers special permissions while live
• Create a "Currently Streaming" category in your member list
• Send notifications when community members go live

How It Works

1. Detection: Streamlinx monitors your server members' Discord presence
2. Twitch Connection: When a member with a connected Twitch account goes live, Discord updates their presence
3. Role Assignment: Streamlinx detects this and assigns the configured "live role"
4. Notification (optional): A notification is sent to a configured channel
5. Role Removal: When the member stops streaming, the role is automatically removed

Requirements:

• Member must have Twitch connected to their Discord account
• Member must be streaming on the connected Twitch channel
• Discord must be open (presence updates require Discord running)

Setting Up Live Roles

Live Roles are configured through the Web Portal.

Step 1: Access the Web Portal

/portal

Navigate to your server and click on "Live Roles" in the sidebar.

Step 2: Create a Live Role Configuration

1. Click "Add Live Role Configuration"
2. Select the Discord role to assign when members go live
3. Choose which notification types to enable:
   • Online notifications (enabled by default) — notify when a member starts streaming
   • Offline notifications (disabled by default) — notify when a member stops streaming
4. Configure filter settings (optional)
5. Click "Save"

Configuration Options

Live Role Selection

Choose which Discord role should be assigned to members when they go live.

Recommendations:

• Create a dedicated role like @Currently Streaming or @Live Now
• Position the role high in your role list if you want it to show prominently
• Give the role a distinctive color so live members stand out

Member Filters

Control which members are eligible for the live role using filters.

Whitelist Mode

Only members with a specific role can receive the live role.

Example Use Case:

• Only verified community streamers get the live role
• Create a @Verified Streamer role and set it as the whitelist

How to Configure:

1. Set Filter Mode to "Whitelist"
2. Select the required role from the dropdown
3. Only members with this role will be eligible

Blacklist Mode (Premium Only)

Members with a specific role are excluded from receiving the live role.

Example Use Case:

• Exclude moderators or staff from the live role
• Block certain members from being highlighted

How to Configure:

1. Set Filter Mode to "Blacklist"
2. Select the role to exclude
3. Members with this role will never receive the live role

Notification Settings

Optionally send notifications when members start or stop streaming.

Notification Types

• Online notifications — sent when a member starts streaming (enabled by default)
• Offline notifications — sent when a member stops streaming (disabled by default)

You can enable both, either, or neither. Role assignment works regardless of notification settings.

Notification Channel

Select a Discord channel to receive live role notifications.

Leave empty to disable notifications (role assignment still works).

Notification Template

Customize the notification message using variables:

Available Variables:

• {member} - The Discord member's display name
• {username} - The member's Discord username
• {role} - The live role being assigned
• {twitch_username} - The member's Twitch username
• {twitch_url} - Direct link to their Twitch stream

Example Template:

{member} just went live on Twitch!
Watch at {twitch_url}

Offline Notifications

You can optionally send a separate notification when a member stops streaming by enabling the Send Offline Notification toggle in the Offline tab. This is independent of the cleanup action — you can edit or delete the original live notification AND send a standalone offline notification.

Display Controls

Customize your notification embeds:

• Hide "Watch Stream" button — Remove the watch button from live notifications
• Hide "View Channel" button — Remove the channel button from offline notifications
• Custom embed color — Set a custom color for the embed sidebar (hex format, e.g., #FF5733)

Tier Limits

Why Multiple Configurations?

Premium users can create multiple live role setups:

• Different roles for different member tiers
• Separate configurations for different games/categories
• VIP streamers get a special role, regular members get a standard one

Best Practices

Create a Distinctive Role

Use Whitelist for Verified Streamers

If you only want community streamers (not random members) to get the live role:

1. Create a @Community Streamer role
2. Manually assign it to verified streamers
3. Set this role as the whitelist filter
4. Only verified streamers will get the live role

Combine with Notification Channels

Create a dedicated channel for member streams:

1. Create #member-streams channel
2. Configure live role notifications to post there
3. Members can follow the channel to get notified
4. Use the template to include the Twitch link

Troubleshooting

Role Not Being Assigned

Check These:

1. Twitch Connected: Member must have Twitch linked to their Discord account

   • Discord User Settings → Connections → Twitch

2. Bot Role Position: Streamlinx bot role must be above the live role

   • Server Settings → Roles → Drag Streamlinx higher

3. Notifications Enabled: Make sure online notifications are toggled on

   • Check in Web Portal → Live Roles → Edit configuration

4. Filter Passed: If using whitelist, member must have the required role

   • Verify member has the whitelist role

5. Discord Presence: Member must have Discord open for presence updates

   • Streaming with Discord closed won't trigger detection

Role Not Being Removed

Possible Causes:

• Discord presence hasn't updated yet (wait 1-2 minutes)
• Member is still streaming
• Bot restarted during stream (manual removal may be needed)

Solution:

• Wait a few minutes after stream ends
• Manually remove the role if needed
• Check bot status in support Discord

Notifications Not Sending

Check These:

1. Notification channel is set
2. Bot has "Send Messages" permission in channel
3. Notification template is valid (not empty)
4. Configuration is enabled

Wrong Members Getting the Role

If unexpected members are getting the live role:

1. Enable whitelist filter
2. Create a dedicated role for eligible members
3. Only assign that role to members you want to have the live role

Frequently Asked Questions

Does this work with YouTube?

No, Live Roles only work with Twitch. YouTube doesn't provide the same Discord integration for live stream detection.

Do members need to do anything?

Members need to:

1. Connect their Twitch account to Discord (User Settings → Connections)
2. Have Discord running while streaming
3. Have the whitelist role (if whitelist filter is enabled)

Can I have different roles for different streamers?

With Premium, you can create up to 5 different live role configurations. Each can use a different role and different filter settings.

Will this work for all Twitch streamers?

Only members of your Discord server who have connected their Twitch account. This doesn't track external streamers - use the regular streamer tracking for that.

How quickly is the role assigned?

Role assignment typically happens within 30-60 seconds of the member going live. Detection depends on Discord updating the member's presence status.

Can I use this with streamer tracking?

Yes! Live Roles and streamer tracking are separate features:

• Live Roles: For members of your server who stream
• Streamer Tracking: For any Twitch/YouTube/Kick channels (don't need to be in your server)

You can use both together.

Live Roles vs Streamer Tracking

Use Both Together:

• Track your favorite streamers with streamer tracking
• Highlight community members with live roles
• Different notification channels for each

Need Help?