What are Ban Appeals?

The Ban Appeals plugin is a premium only plugin that allows banned members of your server to appeal their punishment. We've made it easier for you to create and manage appeals in your server with our form creator, automatic unbanning, prerequisites and so much more.

Getting Started

1. Navigate to your server's dashboard.
2. Select the Ban Appeals plugin. If it's not enabled, you'll need to enable it.
3. Follow the instructions below.

Setting Up the Appeals Log

This is where Circle will log when appeals are created, denied, and accepted.

1. Pick your appeals log from the "Appeals Log" drop-down.
2. Scroll down and press "Save".

Setting the Appeal Turnaround Time

This is how long, in days, it'll take your team to process an appeal. When a user submits a ban appeal to your server, Circle will show them your estimated appeal turnaround time.

1. Specify an amount of days in the "Appeals Turnaround (days)" box.
2. Scroll down and press "Save".

Specifying Appeals Managers

Members with these roles will be able to view, accept, and deny appeals. Server admins will be able to manage appeals regardless of your input here.

1. Select your appeals manager roles in the "Appeals managers" drop-down menu.
2. Scroll down and press "Save".

Preventing Members from Appealing

If the reason for a member's ban includes a string you specify here, they will be ineligible to appeal.

1. Add keywords to the "Banned Reasons" box.
2. Scroll down and press "Save".

Allowing Temporary Bans to be Appealed

1. Tick the "Allow temporary bans to be appealed" box.
2. If you want all bans to be appealable, empty the "Minimum Ban Duration" box. Otherwise, set the input to the amount of days a user must be banned for before they can appeal.
3. Scroll down and press "Save".

Creating Appeal Questions

When users appeal, they will be prompted to answer each of the questions you specify here. They will be able to leave questions that aren't required blank!

1. Click "Create One" or "New Question".
2. Select the question type. If you want to add an alert, select either Information Alert or Danger Alert.
3. Complete the required fields that appear.
4. If you want the question to be optional, click the "Make Optional" button. In a similar vein, if you want the question required, click the "Make Required" button.
5. When you're done making your appeals form, scroll down and press "Save Questions".

Multiple Appeals

1. Tick the "Allow members to appeal more than once" box.
2. Optionally, you can create a cooldown. This is the amount of days between appeal attempts.
3. Scroll down and press "Save".

Updated on: 08/11/2025