> For the complete documentation index, see [llms.txt](https://dbd-ts.gitbook.io/dbdts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dbd-ts.gitbook.io/dbdts/functions/cooldown.md).

# $cooldown

Sets a cooldown.

### Usage

```php
$cooldown[id;time;errorMessage]
```

This function has three params.

| Param        | Description                                             | Type      | Required |
| ------------ | ------------------------------------------------------- | --------- | -------- |
| id           | The user, channel, or guild to assign this cooldown to. | Snowflake | Yes      |
| duration     | How long the cooldown should last.                      | Time      | Yes      |
| errorMessage | The message to return when the cooldown is ongoing.     | String    | No       |

{% hint style="info" %}
You can use \`$get\[time\_left]\` in 'errorMessage' to get how much time is left on the cooldown.
{% endhint %}

### Examples

**Creating a Global User Cooldown:**

```
$cooldown[$authorID;1h;You have to wait $get[time_left] to use this command again!]
```

**Creating a Local User Cooldown:**

```
$cooldown[$guildID_$authorID;1h;You have to wait $get[time_left] to use this command again!]
```

**Creating a Channel Cooldown:**

```
$cooldown[$channelID;1h;You have to wait $get[time_left] to use that command in this channel!]
```

**Creating a Guild Cooldown:**

```
$cooldown[$guildID;1h;You have to wait $get[time_left] to use that command in this channel!]
```