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

# Filters

## How it works?

You can find an explanation [**here**](/overview/how-it-works.md#filters).

{% hint style="danger" %}
Be sure to have read [how to configure a character](/fundamentals/getting-set-up/configure-a-character.md) and [how to configure a behavior](/fundamentals/getting-set-up/configure-a-behavior.md) before starting here.
{% endhint %}

## List

This section lists all the types of filters that can be added to behaviors.

{% hint style="info" %}
Every filters support the [placeholders](/behavior/placeholders.md) which can be used anywhere there is text.
{% endhint %}

{% hint style="info" %}
Each filter contains a "reversed" option. Validate the filter only if the result is invalid.\
Usually, you will choose to set this option to "Disabled".
{% endhint %}

### HAS\_ROLE

Allows you to ignore members who do not have a specific role.

#### Settings

<table><thead><tr><th width="174">Name of setting</th><th width="314.3333333333333">Description</th><th>Type of input</th></tr></thead><tbody><tr><td>Roles</td><td>List of roles to filter.</td><td>Selecting from a defined list</td></tr></tbody></table>

***

### CHANNEL

Allows you to ignore channels other than the one selected.

💡It is very common to add this filter so that a behavior is triggered only when the event is called in a specific channel.

#### Settings

<table><thead><tr><th width="174">Name of setting</th><th width="314.3333333333333">Description</th><th>Type of input</th></tr></thead><tbody><tr><td>Channel</td><td>The only authorized channel.</td><td>Selecting from a defined list</td></tr></tbody></table>

***

### MESSAGE\_CONTAINS

Allows you to ignore messages that do not contain specific text.

💡It is very common to add this filter so that a behavior is triggered only when something is mentioned in a message. For example the name of the character.

#### Settings

<table><thead><tr><th width="174">Name of setting</th><th width="372.3333333333333">Description</th><th>Type of input</th></tr></thead><tbody><tr><td>Content</td><td>The content that the message must contain.</td><td>Text</td></tr><tr><td>Case-sensitive</td><td>Should case sensitivity be checked.</td><td>Enabled/Disabled</td></tr></tbody></table>

***

### MESSAGE\_EQUALS

Allows you to ignore messages that are not exactly the one configured.

#### Settings

<table><thead><tr><th width="174">Name of setting</th><th width="372.3333333333333">Description</th><th>Type of input</th></tr></thead><tbody><tr><td>Content</td><td>The content that must fully correspond to the message.</td><td>Text</td></tr><tr><td>Case-sensitive</td><td>Should case sensitivity be checked.</td><td>Enabled/Disabled</td></tr></tbody></table>

***

### MESSAGE\_STARTS\_WITH

Allows you to ignore messages that do not start with a particular text.

#### Settings

<table><thead><tr><th width="174">Name of setting</th><th width="405.3333333333333">Description</th><th>Type of input</th></tr></thead><tbody><tr><td>Content</td><td>The content with which the message must start.</td><td>Text</td></tr><tr><td>Case-sensitive</td><td>Should case sensitivity be checked.</td><td>Enabled/Disabled</td></tr></tbody></table>

***

### MESSAGE\_ENDS\_WITH

Allows you to ignore messages that do not end with a particular text.

#### Settings

<table><thead><tr><th width="174">Name of setting</th><th width="391.3333333333333">Description</th><th>Type of input</th></tr></thead><tbody><tr><td>Content</td><td>The content with which the message must end</td><td>Text</td></tr><tr><td>Case-sensitive</td><td>Should case sensitivity be checked.</td><td>Enabled/Disabled</td></tr></tbody></table>