Twitch Trigger: Gift Subscription
The Gift Subscription is activated when a user gifts subscriptions in your channel.
Screenshot: The Gift Subscription trigger pictured will only fire whenever someone gifts a subscription.
You must be a Twitch affiliate or partner to have access to subscriptions. You can learn more on Twitch’s website.
Trigger Inputs
Gifter
Username of the user who gifted subscriptions.
If the Username field is left blank, the Gift Subscription trigger will fire regardless of which user gifted subscriptions to your Twitch channel. However, if you specify a username in the Username field, the Gift Subscription trigger will only fire when the display name of the user who gifted subscriptions is an exact match to the text entered into the Username field. (case sensitive)
| Type | Text (String) |
|---|---|
| Default Fallback | Unknown User |
| Min - Max Characters | 4 - 25 |
| Required | No |
| Local Variable | Yes |
Subscription Tier
Subscription tier of the gifted subscriptions. e.g. Tier 1/2/3
If the Subscription Tier field is left blank, the Gift Subscription trigger will fire on Tier 1, 2, and 3 gift subscriptions. However, if you enter 1, 2, or 3 into the Subscription Tier field, the Gift Subscription trigger will only fire when the gift subscriptions are equal to the specified tier. You can also click the cog wheel next to the Subscription Tier field and choose the Range modifier. The range modifier allows you to specify a minimum, maximum or range of gift subscription tiers to activate the Gift Subscription trigger. (example below)
| Type | Whole Number (Integer) |
|---|---|
| Default Fallback | 1 |
| Min - Max Value | 1 - 3 |
| Required | No |
| Local Variable | Yes |
Below is an example usage of the range modifier with the Subscription Tier field. This example will only allow the Gift Subscription trigger to fire when the gifted subscriptions are between Tier 1 and Tier 2.
Total Gifts
Total amount of gift subscriptions given by the user for this transaction.
If the Total Gifts field is left blank, the Gift Subscription trigger will fire with any amount of gifted subscription (max of 100000). However, if you enter a number between 1 and 100000 into the Total Gifts field, the Gift Subscription trigger will only fire when the amount of gifted subscriptions is equal to the number specified. Alternatively you can click the cog wheel next to the Total Gifts field and choose the Range modifier. The range modifier allows you to specify a minimum, maximum or range of total gifts to activate the Gift Subscription trigger. (example below)
| Type | Whole Number (Integer) |
|---|---|
| Default Fallback | 1 |
| Min - Max Value | 1 - 100000 |
| Required | No |
| Local Variable | Yes |
Below is an example usage of the range modifier with the Total Gifts field. This example will only allow the Gift Subscription trigger to fire when the user has gifted at least 10 subs!
Hidden Variables
Hidden Variables are available as Local Variables within the actions of a rule, but you will not see these fields visually on the Trigger. These can also be used with a New Rule Check, more info here on Checks.
There are no hidden variables for this trigger type.