Commands

All Commands listed with an explanation.

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).

Commands marked ⭐ Premium require an active TimeCord subscription for that server. Some commands are only partly premium; that is noted per command.

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)

• 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).

/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.

/break <action>

Pause and resume your own session without clocking out. action is pause or resume. Break time is excluded from your tracked hours, and clocking out while paused is handled correctly. Use it for lunch or an errand so the time in between does not count.

/streak

Shows your current and longest consecutive-day streak, plus the milestones you have earned (for example 100 hours tracked, or a 7-day streak). See Statistics & Time.

/leave <action> ...

Request time off. request opens a request with a start date, end date and reason; list shows your requests. Your request is posted to the access-role staff with Approve and Deny buttons. An approved leave that covers the current day excludes you from quota and shift no-show reports, so being off does not count against you.

/stats [user] ⭐ Premium

Posts a bar chart image of the last 14 days of daily hours, plus your totals. Run it on yourself or pass a user.

---

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).

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.

/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.

/language <language>

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

/weekstart <day> ⭐ Premium

Sets which weekday a week starts on (Monday through Sunday). This changes how weekly stats are grouped. See Statistics & Time.

/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.

/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.

/shift <action> ... ⭐ Premium

Schedule shifts and rosters.

Action	What it does
create	Creates a shift with a name, start, end, and members assigned by role or individually.
list	Lists upcoming shifts.
cancel	Cancels a scheduled shift.

TimeCord sends a reminder about 15 minutes before a shift starts, and after it ends it flags any assignee who never clocked in as a no-show in your logs channel. Members on approved leave are not counted as no-shows.

/quota <action> ... ⭐ Premium

Set and check hour targets.

Action	What it does
set	Sets a weekly and/or monthly hour target per member (0 disables it).
report	Lists members who are below target. Members on approved leave are excluded.

/sanction <action> <user> ... ⭐ Premium

The sanction/penalty system. issue records a sanction (with an optional fine), list shows a user's sanctions, pay marks one as paid, and remove deletes one.

/payrate <action> ... ⭐ Premium

Set the hourly pay for a role. set maps a role to a rate, list shows the current rates, remove deletes one. When a member has several paid roles, the highest rate is used.

/payroll ⭐ Premium

Produces a CSV payroll report: each member's hours times their pay rate, with totals. Uses the rates from /payrate and respects your timezone and week start.

/promotion <action> ... ⭐ Premium

Auto-promote members by all-time hours. set maps an hour threshold to a role, list shows the thresholds, remove deletes one. An hourly job adds the role once a member reaches the threshold. The hours compared are all-time hours (including archived history).

/recap <action> ... ⭐ Premium

Configure a scheduled weekly recap post (top trackers and totals for the server).

Action	What it does
channel	Sets the channel the recap is posted to.
day	Sets which weekday it posts on.
enable / disable	Turns the scheduled recap on or off.
preview	Posts a recap right now so you can see it.

/webhook <action> ... ⭐ Premium

An outbound webhook that receives a periodic stats snapshot (hired count, on-duty count) as JSON every 12 hours. set <url> configures and enables it, disable turns it off, and test sends one immediately. Useful for pushing live status into your own systems.

/audit

Flags suspicious sessions, such as sessions that ran implausibly long or that are still open after a very long time, so you can review and correct them. Admin only.