Jail
DocsModeration

Jail

Set up a restricted jail channel while preserving member roles for release.

What jail does

Jail saves and removes every member role Appear can manage, assigns the jail role, limits the member to the jail channel, and records a moderation case. Releasing the member restores the saved roles that Appear is still able to manage.

Set up jail

  1. 1

    Create or reuse jail resources

    The command creates a jailed role and jail channel when missing, then updates channel permissions.

    Command
    ,jail enable
  2. 2

    Verify access

    Use a test member or carefully inspect the jail role's channel overwrites before using it on active members.

  3. 3

    Jail a member

    Add an optional reason so the moderation case explains why the action was taken.

    Command
    ,jail @member repeated rule violations

Disable or reset

jail disable releases jailed members but leaves the role and channel in place. jail reset releases members and then deletes the jail role and channel. Use reset only when you intend to tear the system down.

moderation

,jail enable

Sets up jail for the server. Creates a `jailed` role and a `jail` channel if they do not exist, then updates every channel so jailed members can only see and talk in the jail channel. Reuses existing ones if you already have them.

,jail enable
User permissionsManage Channels, Manage Roles
Bot permissionsManage Channels, Manage Roles
Open in command browser
moderation

,jail

Jails a member: saves and strips the roles the bot is able to manage, gives them the jail role so they can only use the jail channel, and files a moderation case with the reason. Requires jail to be set up with `jail enable` first.

,jail <user> [reason]
Example,jail @user reason
Arguments
userRequired
reasonOptional
User permissionsManage Messages
Open in command browser
moderation

,jail list

Lists everyone currently jailed in this server along with the reason recorded for each.

,jail list
User permissionsManage Messages
Open in command browser
moderation

,unjail

Releases a jailed member, removing the jail role and giving back the roles they had when they were jailed.

,unjail <user>
Example,unjail @user
Arguments
userRequired
User permissionsManage Messages
Open in command browser
moderation

,jail disable

Turns jail off and releases everyone currently jailed, giving each of them the roles they had before being jailed. Unlike `jail reset`, the jail role and channel are left in place so you can turn jail back on later.

,jail disable
User permissionsManage Channels, Manage Roles
Open in command browser
moderation

,jail reset

Tears jail down completely: releases everyone currently jailed and gives them their old roles back, then deletes the jail role and jail channel. Use `jail disable` instead if you want to keep the jail role and channel for later.

,jail reset
User permissionsManage Channels, Manage Roles
Bot permissionsManage Channels, Manage Roles
Open in command browser

Troubleshooting

  • If a member keeps a role, place Appear above that role and release the member before trying again.
  • If the jail channel is hidden from jailed members, check the jail role overwrite on that channel.
  • If setup cannot update channels, confirm Appear has Manage Channels and Manage Roles.