Shop System
The shop lets viewers spend points on public items. Use it for sound effects, image effects, custom messages, custom events, requests that need manual delivery, or any channel reward that should be bought with points.
Shop settings
Open Shop in the Kicklet dashboard to configure the shop.
| Setting | Description |
|---|---|
| Active | Enables or disables public shop purchases. |
| Command | The chat command that links viewers to the shop. |
| Global cooldown | Minimum time between any two shop purchases. |
| User cooldown | Minimum time between purchases by the same viewer. |
Cooldowns help prevent spam when shop items trigger visible or audible effects.
Shop items
Each item has a name, description, image, price, active state, and position in the public shop. Items can also have:
| Option | Description |
|---|---|
| Stock | Limits how often the item can be bought. Stock is premium-only. |
| Order mode | Marks purchases as orders that need manual delivery. |
| Item command | Optional per-item command or trigger value. |
| Item cooldowns | Global and per-user cooldowns for this specific item. |
| Custom fields | Viewer-entered values required before purchase, such as a name, message, or choice. |
The number of shop items depends on your account limits.
Item actions
Shop items can run one or more actions after purchase:
| Action | Use for |
|---|---|
| Message | Send a chat message after purchase. |
| Code | Run Kicklet template code after purchase. Code actions are premium-only. |
| Image | Show an image effect. |
| Sound | Play a sound effect. |
| Custom event | Trigger an event for overlay widgets or integrations. |
An item cannot use both a message action and a code action at the same time. Use a message action for simple chat output, and use a code action when the response needs Engine v2 expressions, variables, points, shop helpers, or custom automation.
Code actions receive shop-specific template context:
| Variable | Meaning |
|---|---|
sender | The viewer who bought the item, when available. |
item | The shop item name. |
customFields | Submitted custom field values. |
For example, a code action can include the buyer and a submitted custom field:
Thanks {{sender.username}}, your message was: {{customFields.message}}
Use Shop Template Helpers when a code action needs the full configured item data or previous purchase counts.
Orders and sales
Purchases are stored as shop sales. The sales page can be filtered by search, order state, and delivery state. For order items, mark a sale as delivered after fulfilling it.
The shop stats pages show total item count, sales count, points spent, and chart data. Sales can be exported as CSV, either as individual sales or summarized by item and customer.
Public shop
Public shop pages only show active shop items that viewers can buy. Items with custom fields create a checkout session before purchase so Kicklet can validate the submitted field values.