https://github.com/googlefonts/emoji-metadata
Emoji metadata for the construction of pickers
https://github.com/googlefonts/emoji-metadata
Last synced: 6 months ago
JSON representation
Emoji metadata for the construction of pickers
- Host: GitHub
- URL: https://github.com/googlefonts/emoji-metadata
- Owner: googlefonts
- License: apache-2.0
- Created: 2020-09-08T23:23:19.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2025-10-21T00:06:23.000Z (9 months ago)
- Last Synced: 2025-10-21T02:22:24.110Z (9 months ago)
- Size: 511 KB
- Stars: 82
- Watchers: 22
- Forks: 19
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
README
This repository provides metadata to support UX around emoji. In particular, it describes how to construct an emoji picker with full support for skin tones. The json files describe a grid layout for an emoji picker with 9 emoji per row:
* `emoji_13_0_ordering.json` for Emoji 13.0.
* `emoji_13_1_ordering.json` for Emoji 13.1.
* `emoji_14_0_ordering.json` for Emoji 14.0.
* `emoji_15_0_ordering.json` for Emoji 15.0.
* `emoji_15_1_ordering.json` for Emoji 15.1.
* `emoji_16_0_ordering.json` for Emoji 16.0.
* `emoji_17_0_ordering.json` for Emoji 17.0.
As emoji evolves new orderings will be added.
Demo: https://jsbin.com/kesuteh/1/edit?css,js,output
A snippet is shown annotated below:
```js
{
// The is the people section
"group": "People",
"emoji": [
{
// This is the codepoint sequence for the emoji that should show in the grid
// Generally the base is the most neutral version available, such as the
// genderless gold skintone version.
"base": [
128583
],
// These are alternate versions, typically shown as a long-press flyout
"alternates": [
[
128583
],
[
128583,
127995
],
// ...etc...
],
// Emoticon(s)
"emoticons": [
">:P"
],
// Shortcode(s)
"shortcodes": [
":smirk:"
],
// Whether there is an animated version for the base emoji
"animated": true,
// [15.1]: whether the alternates include directional emoji
"directional": false
},
```
Here is what the people section could look like:
Here are the alternates for Santa, as might be shown on long-press for the base Santa:
The https://github.com/googlefonts/noto-emoji repository provides Google's Emoji.