# Timed Messages

A timed message is a chat post you write once that KickBot then sends on a repeating schedule while you stream. Common uses include linking your Discord, plugging your tip page, or reminding viewers to follow.

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

## Add a message

Navigate to [kickbot.com/dashboard/timer](https://kickbot.com/dashboard/timer) and click **Add Message** in the top-right of the **Messages** card. A popup opens where you set the text and the schedule.

<figure><img src="/files/HTvhzbJhbmGvp0SOWpdV" alt="Timed Messages dashboard listing scheduled chat posts with interval and spacing values."><figcaption><p>The timed messages page shows every scheduled post in one table.</p></figcaption></figure>

The popup has three fields:

* **Message.** What KickBot will post in chat. Up to 500 characters.
* **Interval.** How often the message can post. Choose from 5 minutes up to 3 hours.
* **Spacing.** The minimum number of chat messages from other people that must show up between two postings of the same message. Range is 1 to 30.

<figure><img src="/files/1Z67gRn9liPHrfdlmPdg" alt="New Message popup with text, interval, and spacing fields for a Kick timed message."><figcaption><p>Interval and spacing both have to be met before the next post fires.</p></figcaption></figure>

Click **Create Message** to save. The message appears in the table and starts running the next time you stream.

{% hint style="info" %}
The free plan caps you at 3 timed messages. Premium accounts have no cap. If you hit the limit, the **Add Message** button switches to **Limit Reached** until you delete one or upgrade.
{% endhint %}

## How interval and spacing work together

Both have to be satisfied before KickBot posts again. Interval is the clock, spacing is the chat-activity floor.

For example, with an interval of 15 minutes and a spacing of 5, the message can re-post every 15 minutes only if at least 5 other chat messages have come in since the last time it ran. In a slow chat where fewer than 5 messages have been sent in those 15 minutes, KickBot will wait a little longer before posting again. This stops the same announcement from filling a quiet chat.

If you want a message to post strictly on the clock, drop spacing to 1.

## Edit or delete a message

Each row has a pencil and trash icon under **Actions**. The pencil opens the same popup with the message pre-filled, where you can change any field and click **Save Changes**. The trash icon takes two clicks to confirm the delete; the icon turns into a checkmark on the first click.

You can also delete from inside the edit popup using the **Delete** link in the bottom-left corner.

## Troubleshooting

If a timed message is not appearing in chat:

* **Check that KickBot is a moderator on your Kick channel.** Without mod permission, KickBot's posts get filtered out by Kick. Add it at [dashboard.kick.com/community/roles/moderator](https://dashboard.kick.com/community/roles/moderator).
* **Give the spacing some room.** A high spacing value in a slow chat can hold a message back for a long time. If you want it to fire on the clock, lower spacing.

## FAQ

<details>

<summary>How do I set up timed messages on Kick?</summary>

Navigate to [kickbot.com/dashboard/timer](https://kickbot.com/dashboard/timer), click **Add Message**, write your text, pick an interval and a spacing value, and click **Create Message**. Once the requirements are met, KickBot will post the message.

</details>

<details>

<summary>How many timed messages can I have?</summary>

Free accounts can have up to 3 timed messages running at once. Premium accounts have no cap.

</details>

<details>

<summary>What is the shortest interval I can pick?</summary>

5 minutes. The dropdown ranges from 5 minutes up to 3 hours, with steps every 5 minutes for the first hour and then 90 minutes, 2 hours, and 3 hours.

</details>

<details>

<summary>Why is my timed message not posting at the exact interval?</summary>

Spacing also has to be met. A message with a 15-minute interval and a spacing of 10 will not re-post until 10 other chat messages have shown up since the last time it ran, even if 15 minutes have passed.

</details>

<details>

<summary>Do timed messages run when I am offline?</summary>

Yes. As long as the timing and spacing requirements are met, KickBot will post the message.

</details>

## Need help?

Email <support@kickbot.com> or drop into the `#support` channel on the [KickBot Discord](https://discord.gg/MAg3gBbc89) and the team will help you out.


---

# 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/chat-bot/timed-messages.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.
