> For the complete documentation index, see [llms.txt](https://infinitybot.gitbook.io/infinitybot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinitybot.gitbook.io/infinitybot-docs/automatic-moderation/automod-dashboard-manager/custom-keywords.md).

# Custom Keywords

The custom keywords rule will block messages that contain set keywords. You can learn how to enable it with the steps below. 

{% stepper %}
{% step %}

### Decide What Rule You Want To Create

First of all, you will have to decide what rule you want to create. You can do so [here](/infinitybot-docs/automatic-moderation/automod-dashboard-manager.md#decide-what-rule-you-want-to-create).
{% endstep %}

{% step %}

### Enable the Rule

Then, you will need to enable the `Block Custom Words` rule, you can do so by toggling the toggle switch of the correct rule. 

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FKBjK1yNcrJPbNiWIMGI2%2Fcustom.gif?alt=media&amp;token=c2db928d-b021-4a02-bc70-a89f352e8195" alt=""><figcaption></figcaption></figure>

### Or Create a New Rule

In case you enabled the custom words rule before, you will have to create a new one. You can do so by pressing the "Add New Rule" button.&#x20;

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FbdwNphdeUIHUIka4FPyq%2FCustom%20create.gif?alt=media&amp;token=c877b23d-b3bf-4f0d-b3b3-622a5e9e0266" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can create up to 6 custom keyword rules, each rule having up to 1000 keywords.
{% endhint %}
{% endstep %}

{% step %}

### Configure Keywords

After enabling the rule, you will need to enter at least one keyword to it. You can do so by typing the keyword and pressing <kbd>ENTER</kbd>.

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FJBrI7dp1ikQ8cgVeqfYC%2FCustom%20add.gif?alt=media&amp;token=e66d548c-8ede-49fd-9530-86f0151c3d0f" alt=""><figcaption></figcaption></figure>

Additionally, you can also add allowed keywords in the "Allowed Phrases" field.&#x20;

{% hint style="success" icon="lightbulb-on" %}
Don't know what keywords to add? You can use the 'Apply Default Words' button to apply some basic swear words!

![](https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2F60eq23g9pMPDMDgP36CM%2Fimage.png?alt=media\&token=6d3a87b5-5d0e-47e0-9be8-333adaa9fb2e)
{% endhint %}

{% hint style="success" icon="lightbulb-on" %}
You can use [advanced matching](/infinitybot-docs/automatic-moderation/automod-dashboard-manager/advanced-matching.md) and [regex patterns](/infinitybot-docs/automatic-moderation/automod-dashboard-manager/regex-patterns.md) here!
{% endhint %}

{% hint style="success" icon="lightbulb-on" %}
This rule supports mass-adding keywords, useful for long lists!
{% endhint %}
{% endstep %}

{% step %}

### Configure Actions

After that, you will be able to enable actions to take after a user broke the rule.

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FxK9p3BlrgDRdSn3lAkc7%2Fimage.png?alt=media&amp;token=fc389465-bd01-470f-8c0b-e25da0b423b6" alt="" width="304"><figcaption></figcaption></figure>

#### When rule is triggered

In this menu you can select what you want Discord to do when a message triggers this AutoMod rule. You can choose from:

* **Block Message**, this will block the message from being send in your server.
* **Send alert**, this will flag the message for review by one of your moderators.
* **Timeout Member**, this will timeout the member, which will block them from sending any messages in your server.&#x20;

#### Alert Channel

In this menu you can select the channel where you want AutoMod actions to be logged. Make sure this is a moderator-only channel!

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FeJLuYqMBvye5Zt64wnip%2Fimage.png?alt=media&amp;token=2206bf78-aecf-4529-b882-9c10dde9baa1" alt=""><figcaption><p>An example AutoMod log</p></figcaption></figure>
{% endstep %}

{% step %}

### Configure Exemptions

Now you can select channels, categorys and roles that you want the AutoMod rule to ignore. Users with these roles or in these channels can bypass this rule.&#x20;

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FxTHuAI4lXZ926INERrpO%2Fimage.png?alt=media&amp;token=7679a336-2ce6-424d-a2d4-0fac4ee029d8" alt="" width="223"><figcaption></figcaption></figure>

{% hint style="success" icon="lightbulb-on" %}
Both actions and exemptions can be configured as [default settings](/infinitybot-docs/automatic-moderation/automod-dashboard-manager/automod-settings.md#default-settings). This way, they will be the same for all AutoMod rules in your server.&#x20;
{% endhint %}
{% endstep %}
{% endstepper %}

***

#### [Back to main AutoMod Dashboard page](/infinitybot-docs/automatic-moderation/automod-dashboard-manager.md)