Twitch.GiftBomb

Someone gifts several subscriptions at once.

• Platform: twitch
• Shape: giftBomb
• Source event: Twitch.GiftBomb

Usage

Widget.on("Twitch.GiftBomb", (event) => {
  // event.user, event.platform…
});

Fields

• user (string): Display name; «Anonymous» for anonymous gifts.
• userId (string): User id on its platform.
• userLogin (string): Login, lowercase.
• amount (number): How many are gifted.
• recipients (string[]): Who receives them.
• tier (1 | 2 | 3): Subscription tier.
• anonymous (boolean): Whether the gift is anonymous.
• giftBombId (string): Gift bomb id.

It also carries platform (the source platform) and raw (the original payload).

Example

The example payload that reaches the Studio simulator:

{
  "user": {
    "role": 1,
    "badges": [],
    "color": "#1E90FF",
    "subscribed": false,
    "monthsSubscribed": 0,
    "id": "100000004",
    "login": "donregalos",
    "name": "DonRegalos",
    "type": "twitch"
  },
  "messageId": "00000000-0000-4000-8000-000000000003",
  "systemMessage": "DonRegalos is gifting 5 Tier 1 Subs to CanalDePrueba's community! They've gifted a total of 25 in the channel!",
  "isTest": false,
  "broadcaster": {
    "id": "100000000",
    "login": "canaldeprueba",
    "name": "CanalDePrueba",
    "type": "twitch"
  },
  "isInSharedChat": false,
  "isSharedChatHost": false,
  "isFromSharedChatGuest": false,
  "createdAt": "2026-09-26T05:40:12.5324718Z",
  "id": "1000000000000001",
  "total": 5,
  "cumulativeTotal": 25,
  "subTier": "1000",
  "recipients": [
    {
      "id": "100000002",
      "login": "lunagamer",
      "name": "LunaGamer",
      "type": "twitch"
    },
    {
      "id": "100000003",
      "login": "eltacoloco",
      "name": "ElTacoLoco",
      "type": "twitch"
    },
    {
      "id": "100000005",
      "login": "nuberosa",
      "name": "NubeRosa",
      "type": "twitch"
    },
    {
      "id": "100000010",
      "login": "buhosabio",
      "name": "BuhoSabio",
      "type": "twitch"
    },
    {
      "id": "100000011",
      "login": "llamafeliz",
      "name": "LlamaFeliz",
      "type": "twitch"
    }
  ]
}