Skip to main content
Bans don’t always have to be forever. Whether a banned user has made amends, the ban was issued in error, or enough time has simply passed, /unban makes reinstating access clean and straightforward.

​
Description

The /unban command lifts a ban from a previously banned user, allowing them to rejoin your server using a valid invite link. Because banned users are no longer members of your server, you cannot @mention them — instead, you’ll need their Discord User ID, a unique numeric string tied to their account. The unban action and any provided reason are logged in Burger Bot’s moderation records.

​
Usage

/unban 123456789012345678 Appeal accepted, ban lifted

​
Parameters

​
user_id
string
required
The Discord User ID of the banned user you want to unban. This is a numeric string (e.g., 123456789012345678). You can find a user’s ID by looking them up in your server’s ban list in Discord’s Server Settings, or by enabling Developer Mode in Discord and right-clicking their profile.
​
reason
string
An explanation for why the ban is being lifted. Saved to Burger Bot’s moderation log. Useful for recording appeal outcomes or noting that a ban was issued in error.

​
Permissions Required

RoleAccess
Administrator or configured Admin role✅ Can unban users
Moderator❌ No access
Regular members❌ No access

​
Example Usage

Unban a user after a successful appeal: 
/unban 123456789012345678 Appeal accepted - agreed to follow server rules
Unban a user whose ban was issued by mistake: 
/unban 987654321098765432 Ban issued in error, wrong user
Unban without a reason: 
/unban 123456789012345678
To find a user’s Discord ID, enable Developer Mode in Discord (User Settings → Advanced → Developer Mode), then navigate to your server’s ban list in Server Settings. Right-clicking a banned user’s entry will show a Copy User ID option.
Unbanning a user does not automatically reinvite them to your server. Once unbanned, they will need a valid invite link to rejoin. If you’re reinstating a member after an appeal, consider sending them a fresh invite directly.