# Usage

URL: https://zerodev.ca/docs/emoji-locker/usage

> Lock, unlock and list your server's emojis.



Run `/emojilocker`. A panel opens that only you can see, with your server's locked and unlocked emoji counts and three actions.

## Lock Emojis

1. Pick **Lock Emojis**.
2. Pick the emojis to lock from the first menu, or press **Select All**.
3. Pick the roles that may use them from the second menu.
4. Press **Confirm**.

The panel shows its progress, one emoji at a time, then a summary. Each locked emoji gets the roles you picked, plus your `persistentRoles` and AthenaBot's own role.

Locking an emoji that is already locked replaces its roles.

## Unlock Emojis

1. Pick **Unlock Emojis**.
2. Pick the locked emojis, or press **Select All**.
3. Press **Confirm**.

Unlocked emojis can be used by everyone again.

## List Emojis

Pick **List Emojis** to browse your emojis, five per page. Switch between **Locked Emojis**, which shows the roles on each, and **Unlocked Emojis**.

## Things to Know

* Each menu shows up to 25 emojis, the first 25 in your server's list. Lock them in batches if you have more.
* Every lock and unlock is logged in `emojiLocker-logs` with who did it, the emojis and the roles.
* **Cancel** and **Back to Main Menu** both return to the main menu without changing anything.

## Troubleshooting

| Problem                                         | Fix                                                                                             |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Emojis do not change                            | AthenaBot's role needs **Manage Expressions**.                                                  |
| Members with the role still cannot use an emoji | Discord can take a few minutes to update emoji access, and members may need to restart Discord. |
| `/emojilocker` is missing                       | The member's permission level is below `emojilocker_command`.                                   |