> For the complete documentation index, see [llms.txt](https://docs.iynxdev.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iynxdev.com/addon-api/getting-started/internal-api/custom-emojis.md).

# Custom Emojis

This page explains how to work with the internal Emoji API.

## Emoji API

Athena provides a large set of custom emojis that you can use in your plugins. A complete list of these emojis can be found in the [Discord Developer Portal](https://discord.com/developers/applications).

All custom emojis are available in embeds rendered with `.resolveEmbed()`. You can use them with the following placeholder format: `%custom_emoji_<number>%`. The `<number>` corresponds to the emoji ID shown in the Discord Developer Portal.

If you want to use an emoji outside of embeds, such as in buttons or messages, you can retrieve the full emoji and use it directly:

```js
const emoji = this.heart.core.discord.core.emoji.manager.getEmoji('<emoji_number>');

// Example
const testEmoji = this.heart.core.discord.core.emoji.manager.getEmoji(10);
interaction.reply({ content: `${testEmoji}, Hey there!` });
```