> For the complete documentation index, see [llms.txt](https://docs.mythmc.ovh/social/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mythmc.ovh/social/administration/making-your-own-custom-emojis.md).

# Making your own custom emojis

**Emojis** are one of the core parts of **social**. They are used everywhere: in the chat, books, signs, anvils... Server owners who wish to add their own emojis can do so very easily by customizing the emojis module in settings.

<figure><img src="https://4118553225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIuZYDEHzi3qCMdABwKd%2Fuploads%2FktuRzIq9Nf9QQtnItd0R%2FScreenshot%202024-11-15%20at%2019.29.00.png?alt=media&amp;token=ad0bde06-a8e4-48f5-bdce-2cc200c9ac2b" alt=""><figcaption></figcaption></figure>

Let's have a look at this example:

```yaml
  emojis:
  ...
  - name: crossed_swords
    aliases: []
    unicodeCharacter: \u2694\uFE0F
```

* **name:** Name of this emoji that will also be used as an identifier. Must be unique.
* **aliases**: Aliases of this emoji.
* **unicodeCharacter**: Unicode character (or characters) that form this emoji.

This adds the crossed swords emoji (:crossed\_swords:), which can be used with `:crossed_swords:`

## Getting a unicode character

We recommend using the [Emojipedia](https://emojipedia.org) website since it contains every emoji and it's updated frequently. It also provides the technical information we need.

For this example we'll look at the [crossed swords entry](https://emojipedia.org/crossed-swords):&#x20;

<figure><img src="https://4118553225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIuZYDEHzi3qCMdABwKd%2Fuploads%2FqYC0AWoToN9mTPbb0djL%2FScreenshot%202024-11-15%20at%2019.02.13.png?alt=media&amp;token=244194ee-6b2e-4557-a18f-387e5c74a693" alt=""><figcaption></figcaption></figure>

The **technical information** tab contains the information we need:

<figure><img src="https://4118553225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIuZYDEHzi3qCMdABwKd%2Fuploads%2FyfVxmV1Pj0BFyFGk55xp%2FScreenshot%202024-11-15%20at%2019.03.07.png?alt=media&amp;token=c77011d3-76cf-41da-aa88-e55dd3698c5d" alt=""><figcaption></figcaption></figure>

In this case, the unicode character would be `\u2694\uFE0F`.

## Using raw emojis

Raw emojis are emojis that don't add any formatting. This means that **emoji descriptions** will not be shown, making them a good alternative to normal emojis for server-related messages.

Using raw emojis is as easy as replacing `:emoji_name:` with :`raw_emoji_name:`. For example, `:crossing_swords:` would be `:raw_crossing_swords:`. It's worth noting that raw emojis cannot directly be used by players.
