Charity Donation

• Alert key: twitch-charityDonation
• Source: Twitch
• Event list label: Donation
• Carries alert image: yes (extraSettings.contentImage)

Default message template

{{username}} just tipped {{currencySymbol}}{{amount}} to charity {{charity_name}}

Template variables

Use any of these in alert text, TTS, or chat templates. The same names appear under data.extraSettings.* when you subscribe via Overlay.on('alert').

Template variable	Overlay payload field	Description
{{userId}}	data.extraSettings.userId	The user ID of the sender
{{username}}	data.extraSettings.username	The username of the sender
{{displayname}}	data.extraSettings.displayname	The display name of the sender
{{amount}}	data.extraSettings.amount	The amount sent
{{currency}}	data.extraSettings.currency	The currency used
{{currencySymbol}}	data.extraSettings.currencySymbol	The currency symbol used
{{campaign_id}}	data.extraSettings.campaign_id	No description available yet.
{{charity_name}}	data.extraSettings.charity_name	No description available yet.
{{charity_description}}	data.extraSettings.charity_description	No description available yet.
{{charity_logo}}	data.extraSettings.charity_logo	No description available yet.
{{charity_website}}	data.extraSettings.charity_website	No description available yet.

Example payloads

Each scenario below mirrors what Lumia emits in Overlay.on('alert', (data) => …).

$100

{
  "alert": "twitch-charityDonation",
  "dynamic": {
    "value": 100,
    "currency": "USD"
  },
  "extraSettings": {
    "username": "lumiastream",
    "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "amount": 100,
    "currency": "USD",
    "charity_id": "lumia123",
    "charity_name": "Lumia Charity",
    "charity_description": "Give me more lights",
    "contentImage": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "charity_website": "https://lumiastream.com",
    "started_at": "2022-07-26T17:00:03.17106713Z",
    "userId": "",
    "displayname": "",
    "currencySymbol": "",
    "campaign_id": "",
    "charity_logo": ""
  }
}

$200

{
  "alert": "twitch-charityDonation",
  "dynamic": {
    "value": 200,
    "currency": "USD"
  },
  "extraSettings": {
    "username": "lumiastream",
    "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "amount": 200,
    "currency": "USD",
    "charity_id": "lumia123",
    "charity_name": "Lumia Charity",
    "charity_description": "Give me more lights",
    "contentImage": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "charity_website": "https://lumiastream.com",
    "started_at": "2022-07-26T17:00:03.17106713Z",
    "userId": "",
    "displayname": "",
    "currencySymbol": "",
    "campaign_id": "",
    "charity_logo": ""
  }
}

$300

{
  "alert": "twitch-charityDonation",
  "dynamic": {
    "value": 300,
    "currency": "USD"
  },
  "extraSettings": {
    "username": "lumiastream",
    "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "amount": 300,
    "currency": "USD",
    "charity_id": "lumia123",
    "charity_name": "Lumia Charity",
    "charity_description": "Give me more lights",
    "contentImage": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "charity_website": "https://lumiastream.com",
    "started_at": "2022-07-26T17:00:03.17106713Z",
    "userId": "",
    "displayname": "",
    "currencySymbol": "",
    "campaign_id": "",
    "charity_logo": ""
  }
}

Variation conditions

Dimensions you can branch on when configuring alert variations:

• RANDOM
• EQUAL_CURRENCY_NUMBER - Donation Amount is equal to
• GREATER_CURRENCY_NUMBER - Donation Amount is greater than or equal to
• EQUAL_USERNAME
• EQUAL_VARIABLE

Related

• Alert Explorer - live preview of every alert
• Overlay Type Definitions - full AlertEvent TypeScript type