> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeonbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Auto React

> Automatically add emoji reactions to messages that contain specific keywords.

Auto React allows ZEON to automatically react with up to 6 custom or standard emojis whenever a member sends a message containing a specific trigger word or phrase. It's a great way to add interactivity and personality to your server's chat.

<Note>
  **Required Permission:** [Admin Access](/permissions/admin-access) or higher — Server Owner, Extra Owner, Trusted User, or Administrator with a role above the bot can use these commands.
</Note>

***

## Setting Up

Follow these steps to create your first auto-reaction.

<Steps>
  <Step title="Add a Trigger">
    Provide the trigger word and the emojis (separated by spaces) the bot should react with.

    ```bash theme={null}
    .autoreact add hello 👋 ❤️
    ```
  </Step>

  <Step title="Test It">
    Send a message containing the word "hello" in any channel to see the bot react.
  </Step>
</Steps>

<Note>
  The trigger detection is **case-insensitive** and works on **substrings**. This means if your trigger is "hi", the bot will react to "hi", "HI", and even "history".
</Note>

***

## Commands

You can use `.autoreact` or the shorter `.react` alias for all commands.

| Command                                    | Description                                              |
| :----------------------------------------- | :------------------------------------------------------- |
| `.autoreact add <trigger> <emojis>`        | Creates a new auto-reaction                              |
| `.autoreact remove <trigger>`              | Deletes an existing auto-reaction                        |
| `.autoreact editemojis <trigger> <emojis>` | Changes the emojis for an existing trigger               |
| `.autoreact rename <trigger> <new>`        | Changes the trigger phrase for an existing auto-reaction |
| `.autoreact show`                          | Lists all active auto-reactions in the server            |
| `.autoreact reset`                         | Deletes all auto-reactions (requires confirmation)       |

***

## Limitations

<Warning>
  * You can create a maximum of **20 auto-react triggers** per server.
  * Each trigger can have a maximum of **6 emojis**.
  * To prevent rate-limiting, there is a built-in **3-second cooldown** per user for each specific trigger.
  * The bot ignores messages sent by other bots or by blacklisted users.
</Warning>