# Chat Alerts

Chat alerts are an easy way to acknowledge new followers, subs, gifted subs, and KICKs without an on-screen overlay. They are sent in your Kick chat as a regular message from the KickBot bot.

{% hint style="info" %}
This guide assumes you have a KickBot account with your Kick channel connected.
{% endhint %}

## Open the Chat Alerts page

In the KickBot dashboard, open **Chat Alerts** from the **Chat Bot** section of the left navigation. The direct URL is [kickbot.com/dashboard/chatalerts](https://kickbot.com/dashboard/chatalerts).

<figure><img src="/files/CqyhMa4i1TZFq7sFnhDg" alt="Kick alerts dashboard with sub, follow, gifted sub, and KICKs alert cards"><figcaption><p>The Chat Alerts page lists all four alert types in one card.</p></figcaption></figure>

## The four alert types

Each alert has its own toggle, message box, and live preview. Two of them have a **Min** filter for ignoring small amounts.

### Sub Alerts

Triggers when a viewer subscribes or renews their subscription. The message can use `{{username}}` and `{{months}}` variables.

<figure><img src="/files/tHmDL07i80cO9rKz4pFs" alt="Sub alert card with the message input and chat preview"><figcaption><p>The preview row updates as you type so you can check the formatting before saving.</p></figcaption></figure>

### Follow Alerts

Triggers when a viewer follows your channel. The only variable is `{{username}}`.

### Gifted Sub Alerts

Triggers when a viewer gifts subs. The message can use the `{{username}}` and `{{sub_count}}` variables. The **Min** input next to the message sets the smallest gift size that fires the alert. For example, a Min of 5 means only gifts of 5 or more subs post a message in chat.

<figure><img src="/files/awKfxIWuwyhCmYWBIo9D" alt="Gifted sub alert card with message input, Min field, and preview"><figcaption><p>Gifted sub alerts include a Min threshold for filtering smaller gifts.</p></figcaption></figure>

### KICKs Alerts

Triggers when a viewer sends KICKs (Kick's native gifting currency). The message can use the `{{username}}` and `{{amount}}` variables, and the **Min** input works the same way: only KICKs gifts at or above the Min trigger the alert.

<figure><img src="/files/aFOpSrueiWQsM0anm5aT" alt="KICKs alert card with message input, Min field, and preview"><figcaption><p>KICKs alerts have their own Min so you can ignore small drops.</p></figcaption></figure>

{% hint style="info" %}
Each alert message must be between 15 and 300 characters. Empty messages and messages that are too short are rejected when you click **Save Changes**.
{% endhint %}

## Set up the alerts

1. Toggle on each alert you want KickBot to post.
2. Edit the message in the box below the toggle. Insert `{{username}}`, `{{months}}`, `{{sub_count}}`, or `{{amount}}` anywhere in the text.
3. For Gifted Sub Alerts and KICKs Alerts, set a **Min** if you only want to acknowledge larger gifts. Leave it at 0 to fire on every gift.
4. Click **Save Changes** at the bottom of the card. The button only enables when something has actually changed.

The preview row under each message renders exactly what KickBot will post, with the variables filled in by example values.

## Test the alerts

The dashboard lists four test commands in the right-hand sidebar. Anyone with mod privileges (including the streamer) can run them in Kick chat to fire each alert without waiting for a real event.

<figure><img src="/files/wngdXCgKrBUL7OnAclIy" alt="Test Commands sidebar listing the four chat alert test commands"><figcaption><p>Run any of these in your Kick chat to fire a test alert.</p></figcaption></figure>

| Command       | Fires            |
| ------------- | ---------------- |
| `!subtest`    | Sub alert        |
| `!gifttest`   | Gifted sub alert |
| `!followtest` | Follow alert     |
| `!kickstest`  | KICKs alert      |

If a test command does not produce a message, jump to the troubleshooting section below.

## If alerts are not posting

Run through these in order. The first item resolves most reports.

* **Make sure KickBot is a moderator on your Kick channel.** KickBot can often only post in chat with mod privileges. Add it at [dashboard.kick.com/community/roles/moderator](https://dashboard.kick.com/community/roles/moderator).
* **Confirm the alert toggle is on.** A disabled toggle silently skips the event.
* **Check the Min value on Gifted Sub and KICKs alerts.** A Min of 100 means a 50-KICKs gift produces nothing. Drop the Min to 0 to verify.
* **Reload the dashboard and confirm your changes saved.** Unsaved edits do not persist; the **Save Changes** button must be clicked while it is active.
* **Try the matching test command in your Kick chat.** This isolates whether the alert configuration is the problem or whether the real event is not reaching KickBot.

## FAQ

<details>

<summary>How do I set up chat alerts on Kick?</summary>

Sign in at [kickbot.com/dashboard/chatalerts](https://kickbot.com/dashboard/chatalerts), toggle the alerts you want, customize the messages, and click Save Changes.

</details>

<details>

<summary>Does KickBot post a chat message when someone subs or follows?</summary>

Yes. With Sub Alerts and Follow Alerts enabled, KickBot posts your custom message in your Kick chat as soon as the event happens.

</details>

<details>

<summary>Can I only fire the gifted sub alert for big gifts?</summary>

Yes. The Min input next to the message controls the smallest gift size that triggers the alert. Set it to 5, 10, or any number you want and KickBot will skip anything below.

</details>

<details>

<summary>What variables can I use in chat alert messages?</summary>

Sub usesand. Follow uses. Gifted sub usesand. KICKs usesand.

</details>

<details>

<summary>Why is my Save Changes button greyed out?</summary>

Save Changes only activates when at least one setting has actually changed. If nothing on the page differs from what was last saved, the button stays disabled.

</details>

## Need help?

If you have a question or your alerts still are not posting, email <support@kickbot.com> or jump into the `#support` channel on the [KickBot Discord](https://discord.gg/MAg3gBbc89).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kickbot.com/dashboard/alerts/chat-alerts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.