Skip to main content

Member Milestone

  • Alert key: youtube-memberMilestone
  • Source: YouTube
  • Event list label: Member Milestone

Default message template​

{{username}} reached a {{subMonths}} month membership milestone!

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 variableOverlay payload fieldDescription
{{username}}data.extraSettings.usernameThe username of the sender
{{displayname}}data.extraSettings.displaynameThe display name of the sender
{{avatar}}data.extraSettings.avatarThe url of the avatar of the sender for a message
{{userId}}data.extraSettings.userIdThe user ID of the sender
{{tier}}data.extraSettings.tierTier gift
{{subMonths}}data.extraSettings.subMonthsHow many months the user has been subbed for
{{streakMonths}}data.extraSettings.streakMonthsHow many months the user has been subbed for in a row
{{message}}data.extraSettings.messageThe message text sent by the user
{{subPlan}}data.extraSettings.subPlanSubs plan value (1000, 2000, 3000)
{{subPlanName}}data.extraSettings.subPlanNameSubs plan value name (Tier 1, Tier 2, Tier 3)

Example payloads​

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

Lumia reached a 1 month milestone​

{
  "alert": "youtube-memberMilestone",
  "dynamic": {
    "value": 1,
    "username": "lumiastream"
  },
  "extraSettings": {
    "username": "lumiastream",
    "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "message": "What does this button do?",
    "subMonths": 1,
    "streakMonths": 1,
    "tier": "Gold",
    "subPlan": "Gold",
    "subPlanName": "Gold",
    "displayname": "",
    "userId": ""
  }
}

Lumia reached a 6 month milestone​

{
  "alert": "youtube-memberMilestone",
  "dynamic": {
    "value": 6,
    "username": "lumiastream"
  },
  "extraSettings": {
    "username": "lumiastream",
    "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "message": "Half a year already!",
    "subMonths": 6,
    "streakMonths": 6,
    "tier": "Gold",
    "subPlan": "Gold",
    "subPlanName": "Gold",
    "displayname": "",
    "userId": ""
  }
}

Lumia reached a 12 month milestone​

{
  "alert": "youtube-memberMilestone",
  "dynamic": {
    "value": 12,
    "username": "lumiastream"
  },
  "extraSettings": {
    "username": "lumiastream",
    "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png",
    "message": "Been a long time",
    "subMonths": 12,
    "streakMonths": 12,
    "tier": "Gold",
    "subPlan": "Gold",
    "subPlanName": "Gold",
    "displayname": "",
    "userId": ""
  }
}

Variation conditions​

Dimensions you can branch on when configuring alert variations:

  • RANDOM
  • EQUAL_NUMBER - Months as a member is equal to
  • GREATER_NUMBER - Months as a member is greater than or equal to
  • EQUAL_USERNAME
  • EQUAL_VARIABLE