Custom Command
FunctionsMember Functions

$changeNickname

Changes the nickname of a specified member in the server. The nickname can also be left empty to reset the member's nickname.

Usage:

$changeNickname[userID;nickname;reason (optional)]
  1. userID - The ID of the member whose nickname you want to change.
  2. nickname - The new nickname you want to assign to the member. Leave this empty to reset the nickname.
  3. reason - The reason for changing the nickname. This is optional.

Example

Changing a nickname

Changing the nickname of the command author:

Member
9/5/2026

!!exec $changeNickname[$authorID;Steve]

Member
9/5/2026

Hello

Resetting a nickname

Leave the nickname argument empty to reset the member's nickname:

$changeNickname[$authorID;;Reset nickname]

Permissions

The bot requires the "Manage Nicknames" permission to change nicknames and can only change the nicknames of members with roles lower than the bot's highest role.

Discord restriction

Discord doesn't allow bots to change the owner's nickname. If you try to change the nickname of an invalid member or the server owner, an error message will be shown.

Related Functions: $nickname

Difficulty: Easy

Tags: Change Nickname Nickname Member Names Modify Name

Function Cooldown

This function has built-in cooldown. Why? Read more about cooldowns here.

  • Cooldown: 4 minutes
  • Tracked By: User ID
  • Type: userupdate

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

On this page