> For the complete documentation index, see [llms.txt](https://mastodon.gitbook.io/mastodon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mastodon.gitbook.io/mastodon/entities/emoji.md).

# Emoji

## Example

```javascript
{
  "shortcode": "blobaww",
  "url": "https://files.mastodon.social/custom_emojis/images/000/011/739/original/blobaww.png",
  "static_url": "https://files.mastodon.social/custom_emojis/images/000/011/739/static/blobaww.png",
  "visible_in_picker": true,
  "category": "Blobs"
}
```

## Required attributes

### `shortcode`

**Description:** The name of the custom emoji.\
**Type:** String\
**Version history:** Added in 2.0.0

### `url`

**Description:** A link to the custom emoji.\
**Type:** String (URL)\
**Version history:** Added in 2.0.0

### `static_url`

**Description:** A link to a static copy of the custom emoji.\
**Type:** String (URL)\
**Version history:** Added in 2.0.0

### `visible_in_picker`

**Description:** Whether this Emoji should be visible in the picker or unlisted.\
**Type:** Boolean\
**Version history:** Added in 2.0.0

## Optional attributes

### `category`

**Description:** Used for sorting custom emoji in the picker.\
**Type:** String\
**Version history:** Added in 3.0.0

## See also

* [Status#emojis](/mastodon/entities/status.md#emojis)

{% content-ref url="/pages/-Lr2Dehn4lq2gVBLRTnt" %}
[Status](/mastodon/entities/status.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LqIeUboNlM8M2qJ7xXM" %}
[custom\_emojis](/mastodon/methods/instance/custom_emojis.md)
{% endcontent-ref %}

{% embed url="<https://github.com/tootsuite/mastodon/blob/master/app/serializers/rest/custom_emoji_serializer.rb>" %}
app/serializers/rest/custom\_emoji\_serializer.rb
{% endembed %}