> For the complete documentation index, see [llms.txt](https://documentation.proto.cx/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.proto.cx/docs/settings/teamspaces/banning.md).

# Banning

{% hint style="warning" %}
Requires the **Manage/View ban rules and reasons** permission.
{% endhint %}

If a person has demonstrated rude, inappropriate, or abusive behaviour, you can ban them with custom reasons and durations.

Go to **Settings → Teamspace → Banning**.

***

## Configuration

{% tabs %}
{% tab title="Ban rules" %}
{% hint style="info" %}
The number of ban rules available depends on the subscription plan.
{% endhint %}

A ban rule sets a preset ban duration based on the number of prior offences. Ban rules are optional but help assign bans faster.

### Create or edit a ban rule

1. Select an existing rule or select **Create Ban Rule**.
2. Configure the options:

| Field                  | Description                                     |
| ---------------------- | ----------------------------------------------- |
| **Number of offences** | The person's ban count that triggers this rule. |
| **Ban length**         | Duration from minutes to months, or permanent.  |

3. Select **Create** or **Save**.

### Delete a ban rule

1. Select one or more rule checkboxes in the Ban Rules table.
2. Select **Delete Ban Rule** and confirm.
   {% endtab %}

{% tab title="Ban reasons" %}
Ban reasons are internal notes that explain why someone was banned.

### Create or edit a ban reason

1. Select an existing reason or select **Create Ban Reason**.
2. Define the reason with text.
3. Select **Create** or **Save**.

### Delete a ban reason

1. Select one or more reason checkboxes in the Ban Reasons table.
2. Select **Delete Ban Reason** and confirm.
   {% endtab %}
   {% endtabs %}

***

## Apply a ban

{% hint style="info" %}
Applying a ban requires at least one Ban Reason to be defined first.
{% endhint %}

1. Open a person's conversation in the [**Inbox**](/docs/modules/inbox.md) and go to the **Person** tab, or select a person in the [**People**](/docs/modules/people.md) dashboard.
2. Next to their name, open the options menu with **⋮** and select **Ban**.
3. Select a **Reason for the ban** and set the **Ban Length** (defaults to a matching ban rule if one exists).
4. Select **Save**. Any existing ban on the same person is overridden.