From 00073afb3fdc075f4166788bc7f18073dfcd78a5 Mon Sep 17 00:00:00 2001 From: Styler Date: Sun, 13 Sep 2026 17:47:52 +0200 Subject: [PATCH] Changelog: KICKs support for Kick channels Also document the kicks-* session keys and the kicks-latest listener for custom widgets. Claude-Session: https://claude.ai/code/session_01HWqW7TRFkz8KAXyrfqeXFH --- .../dashboard/2026-09-13-kicks-support.mdx | 17 ++++++++ src/content/docs/overlays/events.mdx | 1 + src/content/docs/overlays/session-data.md | 42 +++++++++++++++++++ 3 files changed, 60 insertions(+) create mode 100644 src/content/changelog/dashboard/2026-09-13-kicks-support.mdx diff --git a/src/content/changelog/dashboard/2026-09-13-kicks-support.mdx b/src/content/changelog/dashboard/2026-09-13-kicks-support.mdx new file mode 100644 index 0000000..0e04032 --- /dev/null +++ b/src/content/changelog/dashboard/2026-09-13-kicks-support.mdx @@ -0,0 +1,17 @@ +--- +title: KICKs support for Kick channels +description: KICKs gifts now show up across StreamElements. Alerts, chat alerts, overlay widgets, the activity feed, session data and dashboard stats all understand them. +date: 2026-09-13 +products: [overlays, chatbot] +--- + +Kick channels connected to StreamElements now get the full treatment for **KICKs**, Kick's paid gifts. + +- **Activity feed.** KICKs gifts appear as their own event type, with a filter and a minimum amount setting. +- **Alert box.** A new KICKs alert for Kick channels, with `{name}`, `{amount}` and `{message}` variables and amount-based variations, including "Session top". +- **Overlay widgets.** A KICKs family under the new **KICKs** category: latest gift, total, recent gifts, top gift, top gifter, top gifters list, session amount and a KICKs goal. +- **Custom widgets.** New `kicks-*` [session data keys](/overlays/session-data#kicks) and a `kicks-latest` [listener](/overlays/events#listener-types), shaped like the Twitch cheer keys. +- **Chat alerts.** The chatbot can announce KICKs gifts in chat, with amount-tiered messages. +- **Dashboard.** KICKs totals on the home page stats and events chart. + +Channels that connected before today are being resubscribed to the new Kick event in the background. If your channel does not receive KICKs events, log in to StreamElements again and it will pick them up. diff --git a/src/content/docs/overlays/events.mdx b/src/content/docs/overlays/events.mdx index 77e6b77..ced393b 100644 --- a/src/content/docs/overlays/events.mdx +++ b/src/content/docs/overlays/events.mdx @@ -92,6 +92,7 @@ In the example above you have `obj` forwarded to that function, which has two in | `subscriber-latest` | New subscriber | | `host-latest` | New host | | `cheer-latest` | New cheer | +| `kicks-latest` | New KICKs gift (Kick) | | `tip-latest` | New tip | | `raid-latest` | New raid | | `message` | New [chat message](#chat-message) received | diff --git a/src/content/docs/overlays/session-data.md b/src/content/docs/overlays/session-data.md index 24c9352..9cd37ec 100644 --- a/src/content/docs/overlays/session-data.md +++ b/src/content/docs/overlays/session-data.md @@ -271,6 +271,48 @@ The structure may change over time. To inspect the most up-to-date values, use ` | `data["cheerPurchase-alltime-top-donator"]["name"]` | Username | | `data["cheerPurchase-alltime-top-donator"]["amount"]` | Cheer Donator amount | +## Kick + +Kick channels share the [common keys](#common-keys) plus followers and subscribers, which use the same keys as [Twitch](#twitch). KICKs, Kick's paid gifts, have their own keys. + +### KICKs + +| Key | Description | +|-----|-------------| +| `data["kicks-session"]["amount"]` | KICKs since session start | +| `data["kicks-month"]["amount"]` | KICKs this month | +| `data["kicks-total"]["amount"]` | Total amount of KICKs | +| `data["kicks-count"]["count"]` | Number of KICKs gift events | +| `data["kicks-goal"]["amount"]` | KICKs goal | +| `data["kicks-latest"]` | Latest KICKs gift event | +| `data["kicks-latest"]["name"]` | Latest KICKs gifter | +| `data["kicks-latest"]["amount"]` | Latest KICKs gift amount | +| `data["kicks-latest"]["message"]` | Latest KICKs gift message | +| `data["kicks-session-top-donation"]` | Top KICKs gift in the session | +| `data["kicks-session-top-donation"]["name"]` | Username | +| `data["kicks-session-top-donation"]["amount"]` | KICKs amount | +| `data["kicks-weekly-top-donation"]` | Top KICKs gift in the week | +| `data["kicks-weekly-top-donation"]["name"]` | Username | +| `data["kicks-weekly-top-donation"]["amount"]` | KICKs amount | +| `data["kicks-monthly-top-donation"]` | Top KICKs gift in the month | +| `data["kicks-monthly-top-donation"]["name"]` | Username | +| `data["kicks-monthly-top-donation"]["amount"]` | KICKs amount | +| `data["kicks-alltime-top-donation"]` | Top KICKs gift all time | +| `data["kicks-alltime-top-donation"]["name"]` | Username | +| `data["kicks-alltime-top-donation"]["amount"]` | KICKs amount | +| `data["kicks-session-top-donator"]` | Top KICKs gifter in the session | +| `data["kicks-session-top-donator"]["name"]` | Username | +| `data["kicks-session-top-donator"]["amount"]` | Sum of the KICKs amounts | +| `data["kicks-weekly-top-donator"]` | Top KICKs gifter in the week | +| `data["kicks-weekly-top-donator"]["name"]` | Username | +| `data["kicks-weekly-top-donator"]["amount"]` | Sum of the KICKs amounts | +| `data["kicks-monthly-top-donator"]` | Top KICKs gifter in the month | +| `data["kicks-monthly-top-donator"]["name"]` | Username | +| `data["kicks-monthly-top-donator"]["amount"]` | Sum of the KICKs amounts | +| `data["kicks-alltime-top-donator"]` | Top KICKs gifter all time | +| `data["kicks-alltime-top-donator"]["name"]` | Username | +| `data["kicks-alltime-top-donator"]["amount"]` | Sum of the KICKs amounts | + ## YouTube :::note