// Video Embeds: https://github.com/requarks/wiki/discussions/4580
The Events feature allows you to subscribe to events that fire for the channel, such as follows, hosts, and subscriptions. You can enable/disable an event by clicking on the circular sliding button. To test out an event, click on the Play button/ To set up an event, simply click the Edit button and begin filling in actions. Some event commands have a delay on them due to one or more reasons. In almost all of these cases, these are delays that are typically out of our hands and are based on the way the service we are interacting with has designed things.
For donation/tipping events, it's reliant on the individual service and what it provides access to. Any services that have a way to get real-time events will be done in real-time. Services that do not have real-time events will have a delay on them as we periodically check for new donations/tips.
Generic event commands are a way to centralize your events across multiple platforms. These events will trigger if any individual platform has a similar event that would trigger (EX: The Twitch Channel Followed event command will also trigger the Generic Channel Followed event command). Generic events will only trigger if there is a corresponding event command of the same type for that specific platform. For example, if a platform does not have a Host event command, then that platform will not trigger the Generic Host event command. For easy reference, each generic event command below will list out the images for each platform it supports like so:
This event will run immediately after Mix It Up is launched and logged into the current account. This can be used for setting up certain things for your stream prior to it actually starting (EX: Launching an application, setting Special Identifiers, etc).
This event will run as Mix It Up is being shut down from the current account. This can be used for cleaning up any thing related to using Mix It Up.
This event will run when your stream goes from offline to online. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream is starting. This event provides the following additional Special Identifiers:
This event will run when your stream goes from online to offline. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream has ended. This event provides the following additional Special Identifiers:
This event will run the first time a user follows during this specific session of Mix It Up. This means, that if a user follows, unfollows, and then re-follows quickly, it will only run the first time. The User special identifiers indicate the user that followed. This event provides the following additional Special Identifiers:
This event triggers when a channel hosts your channel. It is often used to thank the user for the host using chat and possibly overlay. Hosts are considered a passive action and therefore do not have a user count associated with them (EX: An auto-host). The User special identifiers indicate the user that hosted. This event provides the following additional Special Identifiers:
This event triggers when a channel raids your channel. It is often used to thank the user for the raid using chat and possibly overlay. Raids are only counted for platforms that specifically distinquish between a host VS a raid (EX: Twitch). The User special identifiers indicate the user that raided. This event provides the following additional Special Identifiers:
This event will run when a user subscribes to your channel. In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:
This event will run when a user resubscribes to your channel. In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:
This event will run for every user that is gifted a subscription by another user in your channel. The User Special Identifiers reference the user that GIFTED the subscription (Ex: $username), while the Target User Special Identifiers reference the user that RECEIVED the subscription (Ex: $targetusername). This event provides the following additional Special Identifiers:
This event will run once for each time a user in your channel gifts a set of subscriptions. This is when a user selects a number of subs to gift all at once to users in the channel. For example, if a user gifts 5 subscriptions to your channel, this event command will be run once, while the Channel Subscription Gifted will be run 5 times, once for each user. The User Special Identifiers reference the user that GIFTED the subscription.
What determines whether this command or the Channel Subscriptions Gifted command will run is based on what is set for the Mass Gifted Subscriptions Filter Amount under Settings -> Commands. This option is designed to help reduce the spam of subscription gifted commands and provide a better experience for your stream. For example, if this option is enabled and the amount is set to 5, then any time 5 OR LESS subscriptions are gifted at once, it will ONLY run the regular Subscription Gifted event command for each subscription. If MORE THAN 5 are gifted, then it will ONLY run the Mass Subscriptions Gifted event command once. Note that this will cause the processing of Subscription Gifted & Mass Subscription Gifted event commands to be slightly delayed, typically less than 10 seconds.
This event provides the following additional Special Identifiers:
This event will run when your stream goes from offline to online. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream is starting. This event provides no additional special identifiers.
This event will run when your stream goes from online to offline. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream has ended. This event provides no additional special identifiers.
This event will run when a change to your stream has been detected such as your title or category. It can be used to either notify your stream about a change or to perform specific actions based on the new changes. This event provides no additional special identifiers, but will often be used with the Stream Special Identifiers.
This event will run the first time a user follows during this specific session of Mix It Up. This means, that if a user follows, unfollows, and then re-follows quickly, it will only run the first time. This event provides no additional special identifiers, however, it is often used with the User special identifiers.
This event triggers when a channel raids your channel. It is often used to thank the user for the raid using chat and possibly overlay. Raids on Twitch are considered an active action and have a user count associated with them. The User special identifiers indicate the user that raided. This event provides the following additional Special Identifiers:
This event triggers when your channel successfully completes a raid to another channel. Note that this will not trigger when you start the raid process (IE, when the countdown starts), but when your stream officially ends and the raided channel is now broadcasting on your channel. The Target User Special Identifiers indicate the user that you are raiding. This event provides no additional special identifiers.
This event will run when a user subscribes to your channel. In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:
This event will run when a user resubscribes to your channel. In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:
This event will run for every user that is gifted a subscription by another user in your channel. The User Special Identifiers reference the user that GIFTED the subscription (Ex: $username), while the Target User Special Identifiers reference the user that RECEIVED the subscription (Ex: $targetusername). This event provides the following additional Special Identifiers:
This event will run once for each time a user in your channel gifts a set of mystery subscriptions. Mystery subscriptions are when the user selects a number of subs to gift and they are randomly gifted out to users in the channel. For example, if a user gifts 5 subscriptions to your channel, this event command will be run once, while the Twitch Channel Subscription Gifted will be run 5 times, once for each user. The User Special Identifiers reference the user that GIFTED the subscription (Ex: $username).
What determines whether this command or the Twitch Channel Subscriptions Gifted command will run is based on what is set for the Twitch Mass Gifted Subscriptions Filter Amount under Settings -> Commands. This option is designed to help reduce the spam of subscription gifted commands and provide a better experience for your stream. For example, if this option is enabled and the amount is set to 5, then any time 5 OR LESS subscriptions are gifted at once, it will ONLY run the regular Subscription Gifted event command for each subscription. If MORE THAN 5 are gifted, then it will ONLY run the Mass Subscriptions Gifted event command once. Note that this will cause the processing of Subscription Gifted & Mass Subscription Gifted event commands to be slightly delayed, typically less than 10 seconds.
This event provides the following additional Special Identifiers:
This event command is run when a user shares out a watch streak within the channel. In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:
This event command is run when the next automatic ad will trigger within the time range specified under Setting -> Commands -> Twitch Upcoming Ad Command Amount (Minutes). For example, if the amount specified is 5 in the settings area, then this command will trigger approximately 5 minutes before the next automatic ad is performed in the channel. This event provides the following additional Special Identifiers:
This event command is run when an ad break startes in the channel. Note that this command is triggered when Twitch notifies of an ad break starting, which is not necessarily when the ad break will start playing for all viewers in the channel. This means that there could be a delay of a few seconds from when this command is triggered to when users start seeing ads on their end. This event provides the following additional Special Identifiers:
This event command is run when an ad break finishes in the channel. Note that this command is triggered based on when Twitch notifies of an ad break starting + the duration of the ad break, which is not necessarily when the ad break will finish for all viewers in the channel. For example, if an ad break starts at 1:10 PM and the duration is 120 seconds, this command will trigger 1:12 PM. This means there could be a delay of a few seconds from when this command is triggered to when users stop seeing ads on their end. This event provides the following additional Special Identifiers:
This event command is run when any form of bits are cheered in your channel which come from chat messages, but not from extensions. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:
This event command is run when any CUSTOM channel points reward is redeemed in your channel, regardless of if it is set to auto-fulfill or must be manually fulfilled. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:
This event command is run when a charity donation is performed in your channel for your set Twitch charity. It provides all of the Donations special identifiers and the User Special Identifiers reference the user who donated. This event provides the following additional Special Identifiers:
This event command runs when a hype chat is performed in your channel. The User Special Identifiers reference the user who performed the hype chat. This event provides the following additional Special Identifiers:
This event command runs when a hype train is starting by Twitch. It is often used to hype up the chat and encourage them to contribute. This event provides the following additional Special Identifiers:
This event command runs when a level up occurs during a hype train on Twitch. This event provides the following additional Special Identifiers:
This event command runs when a hype train is ended by Twitch. It is often used to thank the chat. This event provides the following additional Special Identifiers:
This event will run when your stream goes from offline to online. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream is starting. This event provides no additional special identifiers.
This event will run when your stream goes from online to offline. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream has ended. This event provides no additional special identifiers.
This event will run when a user becomes a new paid member of your channel. The User Special Identifiers reference the user who became the member. This event provides the following additional Special Identifiers:
This event will run when a user reaches a new milestone for their paid membership of your channel. The User Special Identifiers reference the user who is the member. This event provides the following additional Special Identifiers:
This event will run when a user gifts a paid member to another user in your channel. The User Special Identifiers reference the user that GIFTED the membership (Ex: $username), while the Target User Special Identifiers reference the user that RECEIVED the membership (Ex: $targetusername). This event provides the following additional Special Identifiers:
This event will run once for each time a user in your channel gifts a set of memberships. Mass memberships are when the user selects a number of memberships to gift and they are randomly gifted out to users in the channel. For example, if a user gifts 5 memberships to your channel, this event command will be run once, while the YouTube Channel Membership Gifted will be run 5 times, once for each user. The User Special Identifiers reference the user that GIFTED the membership (Ex: $username).
What determines whether this command or the YouTube Channel Membership Gifted command will run is based on what is set for the Mass Gifted Subscriptions Filter Amount under Settings -> Commands. This option is designed to help reduce the spam of membership gifted commands and provide a better experience for your stream. For example, if this option is enabled and the amount is set to 5, then any time 5 OR LESS memberships are gifted at once, it will ONLY run the regular Membership Gifted event command for each subscription. If MORE THAN 5 are gifted, then it will ONLY run the Mass Membership Gifted event command once. Note that this will cause the processing of Membership Gifted & Mass Membership Gifted event commands to be slightly delayed, typically less than 10 seconds.
This event provides the following additional Special Identifiers:
This event will run when a user performs a super chat in your channel. The User Special Identifiers reference the user that performed the super chat. This event provides the following additional Special Identifiers:
This event will run when your stream goes from offline to online. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream is starting. This event provides no additional special identifiers.
This event will run when your stream goes from online to offline. It is often used to send out Discord and Twitter notices to your social media accounts to alert users that your stream has ended. This event provides no additional special identifiers.
This event will run the first time a user follows during this specific session of Mix It Up. This means, that if a user follows, unfollows, and then re-follows quickly, it will only run the first time. This event provides no additional special identifiers, however, it is often used with the User special identifiers.
This event triggers when a channel raids your channel. It is often used to thank the user for the raid using chat and possibly overlay. The User special identifiers indicate the user that raided. This event provides the following additional Special Identifiers:
This event will run when a user subscribes to your channel. In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:
This event will run when a user resubscribes to your channel. In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:
This event will run for every user that is gifted a subscription by another user in your channel. The User Special Identifiers reference the user that GIFTED the subscription (Ex: $username), while the Target User Special Identifiers reference the user that RECEIVED the subscription (Ex: $targetusername).
This event will run once for each time a user in your channel gifts a set of subscriptions. This is when a user selects a number of subs to gift all at once to users in the channel. For example, if a user gifts 5 subscriptions to your channel, this event command will be run once, while the Trovo Channel Subscription Gifted will be run 5 times, once for each user. The User Special Identifiers reference the user that GIFTED the subscription.
What determines whether this command or the Channel Subscriptions Gifted command will run is based on what is set for the Mass Gifted Subscriptions Filter Amount under Settings -> Commands. This option is designed to help reduce the spam of subscription gifted commands and provide a better experience for your stream. For example, if this option is enabled and the amount is set to 5, then any time 5 OR LESS subscriptions are gifted at once, it will ONLY run the regular Subscription Gifted event command for each subscription. If MORE THAN 5 are gifted, then it will ONLY run the Mass Subscriptions Gifted event command once. Note that this will cause the processing of Subscription Gifted & Mass Subscription Gifted event commands to be slightly delayed, typically less than 10 seconds.
This event provides the following additional Special Identifiers:
This event will run when a spell is cast in your channel. If a user casts multiple spells at the same time, this command will only be run once for that batch of spells. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:
This event will run when a magic chat is performed your channel. The User Special Identifiers reference the user who triggered the event and the Arguments Special Identifiers reference the text used.
This event will run the first time a chat user sends a message in chat that is detected by Mix It Up. It will not run again for this user while Mix It Up is still running. If the user has a Custom Entrance Command, that will be triggered instead of this command. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:
This event will run the first time a brand-new chat user sends a message in chat that is detected by Mix It Up .
and it will never run again for this user. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:
This event will run the first time a brand-new chat user is detected in chat by Mix It Up and it will never run again for this user. Note that this is not the same as the first message that a user sends in chat, as there are many ways that a user can join the chat. For example, they can follow, subscribe, redeem a channel point, etc. All of these cause the user to appear to us in chat and will trigger the event. This event provides no additional special identifiers. However, it is often used with the User special identifiers.
This event will run the first time a chat user is detected in chat by Mix It Up. It will not run again for this user while Mix It Up is still running. Note that this is not the same as the first message that a user sends in chat, as there are many ways that a user can join the chat. For example, they can follow, subscribe, redeem a channel point, etc. This can even include a user connecting to chat, but not interacting with it in anyways. All of these cause the user to appear to us in chat and will trigger the event. This event provides no additional special identifiers. However, it is often used with the User special identifiers.
This event will run the first time a chat user has left chat as detected by Mix It Up. It will not run again for this user while Mix It Up is still running. This event provides no additional special identifiers. However, it is often used with the User special identifiers.
This event triggers every time a chat message is received in chat. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:
This event triggers every time a chat whisper is received on your main Streamer account in chat. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:
This event triggers every time a chat message is deleted in chat. The User Special Identifiers reference the user who performed the deletion if we could detect them and the Target User Special identifiers reference the user whose message was deleted. This event provides the following additional Special Identifiers:
This event will run when a user has been timed out in chat. This event does not indicate who performed the timeout, only the user that was timed out. The Target User Special Identifiers will indicate the user that was timed out. This event provides the following additional Special Identifiers:
This event will run when a user has been banned in chat. This event does not indicate who performed the ban, only the user that was banned. The Target User Special Identifiers will indicate the user that was banned. This event provides no additional special identifiers.
This event fires when a Streamlabs donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation.
This event fires when a StreamElements donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation.
This event fires when a StreamElements merchandise purchase is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation. The Argument Special Identifiers correspond to each unique item and the amount of that item (EX: $arg1text = "Shirt x2"). The following additional Special Identifiers are available:
This event fires when a TipeeeStream donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation.
This event fires when a Rainmaker donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation.
This event fires when a TreatStream donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation.
This event fires when a Tiltify donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation.
This event fires when an Donor Drive donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation. Additionally, you can use the globally available Donor Drive special identifiers with this command and others.
This event fires when an Donor Drive Incentive is included in a donation. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation. Additionally, you can use the globally available Donor Drive special identifiers with this command and others. The following additional Special Identifiers are available:
This event fires when an Donor Drive Milestone has been reached. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation. Additionally, you can use the globally available Donor Drive special identifiers with this command and others. The following additional Special Identifiers are available:
This event fires when an Donor Drive Team Incentive is included in a donation. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation. Additionally, you can use the globally available Donor Drive special identifiers with this command and others.
Team incentives are only included if the "Include Team Donations / Events" option is toggled under Services -> DonorDrive.
The following additional Special Identifiers are available:
This event fires when an Donor Drive Team Milestone has been reached. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation. Additionally, you can use the globally available Donor Drive special identifiers with this command and others.
Team incentives are only included if the "Include Team Donations / Events" option is toggled under Services -> DonorDrive.
The following additional Special Identifiers are available:
This event fires when a JustGiving donation is detected. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that sent the donation.
This event fires when any Crowd Control effect has redeemed. It shares the same Special Identifiers that can be found for Crowd Control Commands.
This event fires when any heart range change is detected from Pulsoid. It shares the same Special Identifiers provided by the Pulsoid service.
This event runs whenever a user subscribes to your linked Patreon account. It provides all of the Donations special identifiers along with all of the standard User special identifiers that represent the user that subscribed. The following additional Special Identifiers are available:
This event runs whenever a user redeems a Streamloots card. The User Special Identifiers reference the user that redeemed the card. This event provides the same Special Identifiers as Streamloots Card Commands.
This event runs whenever a user purchases a pack of Streamloots cards. The User Special Identifiers reference the user that purchased the pack. This event provides the following additional Special Identifiers:
This event runs whenever a user gifts a pack of Streamloots cards to another user. The User Special Identifiers reference the user that GIFTED the pack, while the Target User Special Identifiers reference the user that RECEIVED the pack. This event provides the following additional Special Identifiers: