Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

emoji.json

by Amio

An npm package with one JSON list of all Unicode emoji (code points, character, name, category), generated from Unicode's emoji-test.txt.

Emoji Code libraryOpen source

GitHub repo
All entries of the list counted per group after removing repeated names, and a search for "cat" that returns codes, names and subgroups.
Made by AgentGid with emoji.json 16.0.0 (npm tarball, sha1 checked against the registry). The package is MIT licensed; the picture shows only names, codes and counts from its data, no emoji artwork.

2. Commercial use: github.com/amio/emoji.json/blob/master/package.json

“"license": "MIT"”

The package is marked MIT, which allows use in paid products.

github.com/amio/emoji.json/blob/master/package.json

License checked Nov 5, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error

emoji.json: one list of every emoji with its name

emoji.json is a free data file that lists every standard emoji with its code, the character itself, its English name and its group, such as Smileys & Emotion or Flags. It is made from the official Unicode emoji list. Use it to build emoji search, pickers or checks; it contains no pictures, so the emoji look like the user's own system font unless you add an image set.

Where you can use it

Emoji search by name Idea

Let people type "cat" or "heart" and find the matching emoji, using the English names in the list.

Your own emoji picker tabs

Your own emoji picker tabs Idea

Sort emoji into tabs like Smileys, Animals, Food and Flags with the group and subgroup that every entry carries.

A small list of emoji characters

Load only the short file with the characters themselves, for example to check whether a reaction someone sends is a real emoji.

Emoji names for screen readers Idea

Use the English name of each emoji as the alt text or label next to an emoji image, so blind users hear "grinning cat" instead of nothing.

Emoji data straight from a link

Read the list from a public link without installing anything, for a quick prototype or a no-code tool.

As reported by Amio: Gets its data from Unicode's emoji-test.txt with its own script.

emoji.json popularity

17 / 100
Gid Score, same scale as developer tools
303
GitHub stars
6,284
npm downloads, last 7 days
+12.9% in 4 weeks
emoji.json: downloads per weeknpm, emoji.json 5,386
emoji.json: GitHub starsamio/emoji.json 303

Downloads from api.npmjs.org, stars from GitHub, checked Nov 19, 2026. How the Gid Score is calculated

How to start

Tell your AI assistant

“Install emoji.json at version 16.0.0, keep only the first entry for each emoji name, and build an emoji search that matches whole words in the name field.”

Or install it yourself.

npm install emoji.json
Show code

Load the list; each entry has codes, char, name, category, group and subgroup.

var emoji = require('emoji.json')
console.log(emoji[2])

Mistakes to avoid

Showing every entry of emoji.json in a picker
Keep only the first entry per name (the fully qualified form comes first)

The script keeps all qualification forms but drops the status field, so 1160 names appear more than once (for example ☺️ and ☺ are both "smiling face"); our demo found 5042 entries and 3790 names.

Filtering with e.category === 'Smileys & Emotion' as the README example suggests
Use e.group === 'Smileys & Emotion' (category is "group (subgroup)")

In 16.0.0 category reads like 'Smileys & Emotion (face-smiling)'; the README example shows the shorter older form.

Linking https://unpkg.com/emoji.json/emoji.json in production
Pin the version (emoji.json@16.0.0) or copy the file into your own site

The unversioned link always serves the newest release, and every visitor's browser contacts unpkg.

Showing the 'Component' group as a picker tab
Drop group 'Component' (skin tones and hair styles) before showing emoji to users

Those 9 entries are building blocks, not emoji people pick; our demo counted them as their own group.

License

MIT (declared in package.json; no LICENSE file in the repo). The package says it is under the MIT license, so it is free for paid products. Keep the notice when you copy the file. The emoji names and codes come from Unicode data, which has its own free license with the same kind of notice rule.

Commercial use
Credit
Required

“"license": "MIT" (MIT requires keeping the copyright and permission notice in copies)” github.com/amio/emoji.json/blob/master/package.json

Inside your app or game
Can ship inside your app

“"license": "MIT"” github.com/amio/emoji.json/blob/master/package.json

Pass the files on to your users
With conditions

Copying and sharing the file is allowed with the MIT notice and the Unicode notice; the repo has no license text, so name the package and its MIT license.

“to deal in the Data Files or Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Data Files or Software” unicode.org/license.txt

AI training
Not stated
Bots and bulk downloads
Not stated

AllowedWith conditionsNot allowedNot stated or not checked yet

Is emoji.json free for commercial use? The full answer Not legal advice. Check the license page before you ship.

For your agent

License rules tell your agent what it may do with emoji.json. Paste them into your prompt or AGENTS.md.

License rules
- emoji.json (Emoji). An npm package with one JSON list of all Unicode emoji (code points, character, name, category), generated from Unicode's emoji-test.txt. Price: free; commercial use OK; credit required.
  Connect: npm emoji.json.
  Rule: The MIT license covers the package's JSON metadata and script, not any emoji artwork; the package ships no images.
  Rule: Keep the MIT notice (author Amio) when you redistribute the JSON files.
  Rule: The underlying emoji names and code points come from Unicode's emoji-test.txt under the Unicode license.
  License: https://github.com/amio/emoji.json/blob/master/package.json (checked 2026-11-05; details: https://agentgid.com/assets/emoji-json/)
Can an agent use it by itself?
Yes.

Agent installs a package or loads it from a CDN.

Install
npm install emoji.json
Repository
API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Emoji data: emoji.json (MIT), based on Unicode emoji-test.txt
This card for machines

Alternatives

emoji.json This page

Free Commercial OK npm

Emojibase

Pick Emojibase when you need emoji names in many languages, shortcodes or skin tone groups in ready data files.

Free Commercial OK npm

emojilib

Pick emojilib when you need several search keywords per emoji, not just one official name.

Free Commercial OK npm

Emoji Mart

Pick Emoji Mart when you want a finished emoji picker instead of building one from raw data.

Free Commercial OK npm

Emoji Datasource

Emoji data in JSON plus spritesheet images from Apple, Google, Twitter and Facebook sets, distributed on GitHub and npm.

Free With conditions npm

Fluent Emoji

Microsoft Fluent emoji assets under MIT, in a GitHub repo.

Free Commercial OK Download

All emoji

Questions

Does emoji.json include emoji pictures?

No. It holds only text data (codes, characters, names and groups); the look comes from the system font or an image set you add.

Where does the data come from?

From the official Unicode emoji-test.txt file, turned into a list by the project's own script.

Is there a smaller file?

Yes. emoji-compact.json holds only the emoji characters, without names or groups.

Can I use it in a paid app?

Yes. The package is marked MIT, which allows commercial use; keep the notice when you copy the file.