---
title: "Custom emoji"
space: "Raven"
url: "https://docs.frappe.io/raven/administration/custom-emoji"
updated: "2026-10-19"
---

Custom emoji are images your team adds to Raven. Everyone on the site can use them in messages and reactions, next to the standard emoji.

Anyone on Raven can add custom emoji. Manage them in **Settings > Emojis**.

<picture>
  <source srcset="/files/raven-dark-admin-emoji-list.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-admin-emoji-list.webp" alt="Settings, on the Emojis tab">
</picture>

## Add an emoji

1. Open **Settings > Emojis**.
2. Click **Upload**.
3. Drop an image in the box, or click it to choose a file.
4. Check the **Emoji Name**. Raven fills it in from the file name.
5. If you like, enter **Keywords**, separated by commas.
6. Click **Save**.

<picture>
  <source srcset="/files/raven-dark-admin-emoji-add.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-admin-emoji-add.webp" alt="The Add Emoji dialog" width="624">
</picture>

| Rule | Details |
| :--- | :--- |
| File types | .jpeg, .jpg, .png, .svg, .gif or .webp |
| Image size | 128 × 128 px is recommended. |
| File size | Your site's upload limit applies. |
| Name | Up to 20 characters: lowercase letters, numbers and underscores. Each name can be used once. |
| Keywords | Optional. People can find the emoji in the picker by these words as well as by its name. |

The image is saved as a public file on your site.

## Use an emoji

Custom emoji are in the emoji picker. In the message box, type **:** and the emoji name, such as `:shipit`. See [Emoji and reactions](wiki:ea5fa90f4f49).

## Delete an emoji

1. Open **Settings > Emojis**.
2. Click the trash button on the emoji's row.
3. Click **Delete** to confirm.

Deleting an emoji can't be undone. It is no longer available in reactions or messages.

:::note
You can delete the emoji you added. Raven admins and System Managers can delete any emoji.
:::

## On the mobile app

Custom emoji are in the emoji picker on the mobile app too. To add or delete them, use Raven on a computer.