# Using the !clip command

The clip command turns the last few moments of your stream into a shareable clip on demand. Viewers type `!clip` (or `!clip 45` for a custom duration) and KickBot replies in chat with a link to the new clip.

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

## Turn on the clip command

Navigate to [kickbot.com/dashboard/clipcommand](https://kickbot.com/dashboard/clipcommand) and toggle **Enabled** in the top-right of the **Command Settings** card.

<figure><img src="/files/k9TGC89tqBtEJd3OWA5s" alt="Clip Command dashboard with Command Settings, role selector, length sliders, and custom response."><figcaption><p>The clip command page on the KickBot dashboard.</p></figcaption></figure>

{% hint style="info" %}
After flipping the toggle on for the first time, the command can take up to five minutes to start responding in chat. Run a test clip in your own chat once the wait is over.
{% endhint %}

## Pick who can run it

The **Who Can Use** row is how you decide which viewers are allowed to clip. The streamer account always has access regardless of which buttons are toggled.

<figure><img src="/files/9jjKAarg6O34pcxwuG85" alt="Who Can Use row with Subs and VIPs selected for the kick clip command."><figcaption><p>Subscribers and VIPs selected. The summary text below updates to reflect the current selection.</p></figcaption></figure>

* **Everyone.** Anyone in chat can run `!clip`. This overrides the role-specific buttons.
* **Subs, VIPs, Mods.** Stack any combination. For example, with Subs and Mods selected, only subscribers and moderators can clip.

If none of the four buttons are on, only you can clip.

## Length controls

{% hint style="info" %}
Default length and maximum length are premium settings. On the free plan the clip command runs at a fixed 30-second default with a 120-second cap.
{% endhint %}

Two sliders set the bounds for any clip created from chat:

* **Default Length.** Used when a viewer types `!clip` with no number. Range is 10 to 120 seconds.
* **Maximum Length.** The longest clip a viewer can request with `!clip <seconds>`. Range is 10 to 240 seconds (four minutes).

For example, with a Default of 30 and a Maximum of 90, `!clip` produces a 30-second clip and `!clip 90` produces a 90-second one. A viewer asking for `!clip 200` is capped at 90.

## Custom response

{% hint style="info" %}
The custom response is a premium setting. Free accounts get the default `@{user} {clip_url}` reply.
{% endhint %}

The **Custom Response** input is the chat message KickBot posts after a clip is created. Two variables are available:

* `{user}` is replaced with the chatter who ran the command.
* `{clip_url}` is replaced with the link to the new clip.

The chat-style preview under the input shows what the message will look like once the variables are filled in.

<figure><img src="/files/N2WPq32msvqnp4z8WTuc" alt="Custom response input and chat preview showing the kick clip URL."><figcaption><p>The default template posts the clipper's name and the clip URL.</p></figcaption></figure>

Messages must be between 15 and 300 characters. Click **Save Changes** under the form when you are happy with it.

## How viewers use it

Once the command is on, anyone allowed by the role settings can run it from your Kick chat:

* `!clip` posts a clip at the default length.
* `!clip 45` posts a 45-second clip. Any value between 10 and your configured maximum works.

KickBot replies in chat with the configured response and the clip URL.

## Where your clips live

Every clip created through `!clip` is saved to your KickBot clips page at `kickbot.com/clips/yourchannel`. The same clips also show up under the **Created Clips** section of the dashboard, where you can sort by date or views, hover any thumbnail to delete a single clip, or use **Select Clips** to remove several at once.

## Troubleshooting

If `!clip` is not posting in chat:

* **Check that KickBot is a moderator on your Kick channel.** The bot needs mod permission to post replies. Add it at [dashboard.kick.com/community/roles/moderator](https://dashboard.kick.com/community/roles/moderator).
* **Check who you let use the command.** If only Subs is on, a regular viewer running `!clip` is silently ignored.
* **Wait five minutes after enabling.** The command can take a few minutes to come online after first being toggled on.
* **Check that your stream is live.** Clips can only be cut from a live broadcast.

## FAQ

<details>

<summary>How do I let viewers clip my Kick stream?</summary>

Turn on the clip command at [kickbot.com/dashboard/clipcommand](https://kickbot.com/dashboard/clipcommand), then toggle **Everyone** under **Who Can Use**. Anyone in chat can then type `!clip` to make a clip.

</details>

<details>

<summary>What chat command makes a clip on Kick?</summary>

The Kick clip command is `!clip`. Adding a number, like `!clip 60`, asks for a clip of that length in seconds, up to the maximum length you set.

</details>

<details>

<summary>How long can a clip be?</summary>

Between 10 seconds and 4 minutes. The free plan caps clips at 120 seconds. Premium streamers can raise the cap to 240 seconds and pick the default length viewers get when they type `!clip` with no number.

</details>

<details>

<summary>Can I limit the clip command to subscribers or mods?</summary>

Yes. Turn off **Everyone** and toggle any combination of **Subs**, **VIPs**, and **Mods**. Only viewers in the selected roles can clip. You always retain access yourself.

</details>

<details>

<summary>Where do clips made with !clip end up?</summary>

They appear in the **Created Clips** section of the dashboard and on your public KickBot clips page at `kickbot.com/clips/yourchannel`. The chat reply also includes a direct link to the clip.

</details>

## Need a hand?

Email <support@kickbot.com> or jump into the `#support` channel of the [KickBot Discord](https://discord.gg/MAg3gBbc89) and we will help you sort it 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/using-the-clip-command.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.