# Emoji Locker

URL: https://zerodev.ca/docs/medusa/paid-modules/emojilocker

> Limit custom server emojis to the roles you choose, from one panel.



Discord lets a custom emoji be limited to certain roles. Emoji Locker gives staff a panel to do that for many emojis at once.

## Using the Panel

Run `/emojilocker` to open the panel. Only you can see it.

**Lock Emojis**

1. Pick the emojis to lock, or press **Select All**.
2. Pick the roles that may use them.
3. Confirm. Medusa updates each emoji and shows its progress.

**Unlock Emojis**: pick locked emojis and confirm. Everyone can use them again.

**List Emojis**: browse locked emojis with their roles, and unlocked emojis, page by page.

Medusa's own role is always kept on locked emojis so the bot can still use them. **Persistent Roles** are added to every emoji you lock as well, which suits staff or booster roles.

<Callout type="warn">
  Medusa needs the **Manage Expressions** permission to change emojis.
</Callout>

## Settings

| Setting          | Default     | What it does                                          |
| ---------------- | ----------- | ----------------------------------------------------- |
| Main Menu Style  | Select Menu | Show the panel's actions as a select menu or buttons. |
| Persistent Roles | None        | Roles added to every locked emoji.                    |

## Commands

| Command        | What it does                                                                                                                                  |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `/emojilocker` | Open the panel. Admin rank by default.                                                                                                        |
| Inspect Emojis | Right-click a message, then **Apps > Inspect Emojis**, to see which roles can use its custom emojis. Off by default on the **Commands** page. |

The **Emoji Locker Events** log records emojis being locked and unlocked.