Syntax

$getCustomStatus[(userID)]

Parameters

Parameter	Description
userID	Optional - The ID of the target user. Default: the command author.

Return Value

• Type: String
• The custom status text of the user.
• An empty string if the user has not set a custom status.

Behavior

• Reads the custom status from the Discord presence of the user.
• Only returns the text, not the optionally associated emoji.
• The user must be visible to the bot (shared server, presence accessible).

Examples

Simple display

$title[💬 Custom Status]
$var[status;$getCustomStatus[$authorID]]
$if[$var[status]!=]
  Your custom status: **$var[status]**
$else
  You have not set a custom status.
$endif
$sendMessage[]

Rich profile card

$title[👤 $userName[$mentioned[1]]]
$description[
**Status:** $userStatus[$mentioned[1]]
**Custom Status:** $getCustomStatus[$mentioned[1]]
**HypeSquad:** $hypeSquad[$mentioned[1]]
]
$thumbnail[$userAvatar[$mentioned[1]]]
$color[#5865F2]
$sendMessage[]

Status change log

$var[newStatus;$getCustomStatus[$authorID]]
$if[$var[newStatus]!=]
  📝 **$userName** changed their custom status: *$var[newStatus]*
$endif

Notes

• The custom status is distinct from the presence status (online, dnd, etc.) which is retrieved via $userStatus[].
• If the user has set an emoji in their status, only the text is returned.
• The custom status can contain up to 128 characters.