$status

Required Tier 3+

Returns the status of a user. Can be online, offline, idle or dnd.

Usage

$status[userID]

1. userID - (Optional) default value: $authorID. The ID of user to return the status from.

Example

Using $status

How to use $status

User07/28/2026

!!exec $status

Custom Command Bot 07/28/2026

online

Important Note

This function requires the Presence Intent to be enabled. You can change that in Discord Developer Portal under your Bot settings.

Related functions: $membersWithStatus

Function difficulty: Easy

Tags: status member status online offline dnd

⏱️ Function Cooldown

This function has a built-in cooldown to help prevent excessive usage.

Property	Value
⏱️ Duration	4 minutes
🆔 Tracked By	User
🌐 Scope	Userupdate

Functions with the same Scope share cooldowns based on the same Tracked By value.

💎 Tier 3+ servers bypass this cooldown. See Premium Perks.