# Custom Command Setup Guide

### **Getting Started**

For this process you will need a KickBot account. If you do not already have a KickBot account navigate to [kickbot.app](https://kickbot.app) and sign up. For more information, follow [this guide](https://docs.kickbot.com/dashboard/creating-your-account) on getting started.

To start, navigate to the "Custom Command" page under "Chat Bot" in the left-hand navigation.

<figure><img src="https://488718071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OLqbpx7W0nzTqPrmIIl%2Fuploads%2FIjiQ4cT73LrVBfQsveSU%2Fimage.png?alt=media&#x26;token=55e401d0-9d8a-4909-b73f-59984c3483e3" alt=""><figcaption></figcaption></figure>

### Default Commands

By default you will have several preconfigured commands. Every streamer has these commands to set as they see fit.

<figure><img src="https://488718071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OLqbpx7W0nzTqPrmIIl%2Fuploads%2FUVTn7GpyQA5aTnFnorPh%2Fimage.png?alt=media&#x26;token=ce2fd124-767a-4683-8370-17751ca64465" alt=""><figcaption></figcaption></figure>

These Default Commands are:

* **!commands:** Output a list of all enabled commands.
* **!followage:** Let a user know how long they have been following.
* **!lurk:** Send a message that you are lurking.
* **!me:** Send a link to your Kick channel.
* **!so:** Promote another user's Kick channel.
* **!welcome:** Welcomes tagged users to the stream.

Each of these Default Commands can be adjusted through the following settings:

<figure><img src="https://488718071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OLqbpx7W0nzTqPrmIIl%2Fuploads%2FtlJUKt5XgDDyrnPdDa8h%2Fimage.png?alt=media&#x26;token=410419a3-ea12-4cd9-b4de-742ff5c400b6" alt=""><figcaption></figcaption></figure>

* **Command:** The command that triggers this (the ! prefix is automatically added)
* **Response:** The response the bot will send. You can use [variables](https://docs.kickbot.app/dashboard/chat-bot) to make responses more dynamic and to add more information.
* **Who can use this command?:** Select which viewers are allowed to use this command, by default this is set to 'Everyone'. The streamer will always have access.
* **User cooldown:** The minimum amount of time before the same user can use the command again.
* **Global cooldown:** The minimum amount of time before anyone can use the command again.
* **Enabled:** Enable or disable the command.

### Your Commands

You can define your own Custom Commands that allow for more degrees of flexibility than the Default Commands.

<figure><img src="https://488718071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OLqbpx7W0nzTqPrmIIl%2Fuploads%2Fz1vtSZrtl4BfOGYAcOLL%2Fimage.png?alt=media&#x26;token=473aec47-f825-4d1a-a5d6-d6a702e61ee9" alt=""><figcaption></figcaption></figure>

Commands can be edited by clicking the settings button in the top right (the same as Default Commands). In this menu you will also have the option to remove the command. Changes can take up to 30 seconds to be reflected in Kick chat.

{% hint style="info" %} <mark style="color:blue;">Free users can only have 5 custom commands enabled at once, while premium users can have unlimited. Default commands do not count towards this limit.</mark>
{% endhint %}

### **Using Custom Commands**

Your custom commands will now be available in your Kick Chat! Simply type the command in chat and KickBot will respond to it.

<figure><img src="https://488718071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OLqbpx7W0nzTqPrmIIl%2Fuploads%2FbkDUpKzwT6NgPmB0Jjtr%2FCleanShot%202023-08-14%20at%2013.19.10%402x.png?alt=media&#x26;token=4b6ebe36-f9fb-41bd-91fe-77f3d6bebd4e" alt=""><figcaption></figcaption></figure>