> For the complete documentation index, see [llms.txt](https://docs.timecord.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timecord.dev/docs/guide/commands.md).

# Commands

Every command is a Discord slash command. Type `/` in any channel to see them, with inline descriptions in your server language (English or German).

{% hint style="info" %}
Commands marked **⭐ Premium** require an active TimeCord subscription for that server. Some commands are only partly premium; that is noted per command.
{% endhint %}

**Who can use what**

* **Everyone** can use the member commands below.
* **Admin commands** require either the Discord `Administrator` permission or one of the management roles you set as *access roles* in the dashboard.
* Every command can be individually enabled, disabled, or restricted to admins under **Dashboard → Settings → Commands**.

***

### Member commands

#### `/help`

Shows links to this documentation and to our support server.

#### `/info` `[user]`

Shows a member profile:

* Hired since, and current duty status (clocked in since, or last time clocked out)
* Job and rank, if configured (see [Ranks](broken://pages/4SdD2jtqo9WeGxvyS6db))
* Number of **active** warnings
* Daily, weekly, monthly and all-time hours

Run it on yourself, or pass a `user` to view someone else.

#### `/leaderboard` `<timeframe>`

Ranks members by tracked hours. `timeframe` is one of `alltime`, `monthly`, `weekly`, `daily`. The list is **paginated** (10 per page) with ◀ / ▶ buttons, and it respects the server timezone and week start (see [Statistics & Time](/docs/guide/statistics-and-time.md)).

#### `/overview`

Lists everyone who is currently clocked in and how long they have been on duty.

#### `/timerequest` `<action> <minutes> <reason> [proof-link] [proof-attachment]` ⭐ Premium

Lets a member request a time change instead of an admin doing it manually.

* `action` - `give` (request time added) or `remove` (request time removed)
* `minutes` - how many minutes
* `reason` - why
* `proof-link` / `proof-attachment` - optional evidence (a link and/or an image/video)

The request is posted to your access-role staff with **Approve** and **Reject** buttons. On approval the time is applied automatically and the member is notified.

***

### Admin commands

#### `/employee` `<user> <action>`

Manage a single employee.

| Action    | What it does                                                              |
| --------- | ------------------------------------------------------------------------- |
| `hire`    | Allows the user to track time. This is the requirement for tracking.      |
| `dismiss` | Revokes tracking. Their data is kept.                                     |
| `stop`    | Ends their active session; the user **keeps** the tracked time.           |
| `cancel`  | Ends their active session; the user gets **no** time.                     |
| `delete`  | Permanently deletes all of the user's data (asks for confirmation first). |

{% hint style="info" %}
Hiring and dismissing can also happen automatically: enable auto-hire on join, or set **autoroles** in the dashboard so that gaining/losing a role hires/dismisses the member.
{% endhint %}

#### `/tracking` `<action>`

Manage server-wide tracking.

| Action     | What it does                                                                      |
| ---------- | --------------------------------------------------------------------------------- |
| `generate` | Posts the time-clock message with **Clock in** / **Clock out** buttons.           |
| `list`     | Shows a **paginated** list of every hired employee (on-duty first, 🟢 = on duty). |
| `stop` ⭐   | Clocks **everyone** out and gives them their time.                                |
| `cancel` ⭐ | Clocks **everyone** out with **no** time.                                         |

`generate` and `list` are free; `stop` and `cancel` are premium.

#### `/time` `<action> <user> <amount>`

Manually adjust a user's time. `action` is `add` or `remove`, `amount` is in minutes.

#### `/timezone` `<timezone>`

Sets the IANA timezone used to bucket daily / weekly / monthly stats, for example `Europe/Berlin`, `America/New_York`, or `UTC` (the default). See [Statistics & Time](/docs/guide/statistics-and-time.md).

#### `/language` `<language>`

Sets the bot's language for this server: `de` (German) or `en` (English).

#### `/weekstart` `<day>` ⭐ Premium

Sets which weekday a week starts on (Monday through Sunday). This changes how weekly stats are grouped. See [Statistics & Time](/docs/guide/statistics-and-time.md).

#### `/cleanup` ⭐ Premium

Removes users from the database who are no longer on the server.

#### `/role` `<action> <role>` ⭐ Premium

Bulk operations on everyone who has a given role.

| Action   | What it does                                    |
| -------- | ----------------------------------------------- |
| `add`    | Hires everyone with the role.                   |
| `remove` | Dismisses everyone with the role.               |
| `reset`  | Resets tracked time for everyone with the role. |

#### `/warn` `<action> <user>` ⭐ Premium

The warning system.

| Action   | What it does                                                       |
| -------- | ------------------------------------------------------------------ |
| `warn`   | Opens a modal to set the reason and duration, then warns the user. |
| `delete` | Removes one of the user's active warns.                            |
| `show`   | Lists the user's active warnings.                                  |

Warnings **expire automatically**: once a warn's duration passes it stops counting and is later cleaned up. See [Statistics & Time](/docs/guide/statistics-and-time.md#warnings).

#### `/export` ⭐ Premium

Exports a **CSV** of every employee's daily, weekly, monthly and all-time hours, ready for payroll. The export respects your timezone and week start. The file is sent privately to you.