KV

The KV variable reads a value from the channel’s key-value storage and includes it in a command response.

Examples

Stream status: {kv stream/status}
Deaths: {kv counter:deaths}
Latest subscriber: {kv latest-subscriber}

Variables

Variable	Use	Example output
{kv <key>}	Shows the current value stored under the KV key.	Live

Strings are shown without quotes. Numbers and booleans use their JSON representation. Objects and arrays are shown as compact JSON.

{kv latest-subscriber}

{"display_name":"Alex","months":3}

A missing, expired or null value produces no text. KV keys are case-sensitive. Do not include private tokens or other secrets in a command response.

Command output from a KV value is limited to 600 characters. Larger values remain available to scripts and widgets, but cannot be included directly in a chat command.

Custom scripts can write KV values through the command script API. Command counters are also stored in KV under keys such as counter:deaths.