# emoji.json — card for AI agents

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

Category: Emoji · maker Amio · checked 2026-11-05

## Price
- Price: Free
- Free tier: Free npm package and JSON files.

## License
MIT (declared in package.json; no LICENSE file in the repo) — https://github.com/amio/emoji.json/blob/master/package.json

- commercial: **yes** (Commercial use OK)
  > "license": "MIT"
  (https://github.com/amio/emoji.json/blob/master/package.json)
- attribution: **required** (Credit required)
  > "license": "MIT" (MIT requires keeping the copyright and permission notice in copies)
  (https://github.com/amio/emoji.json/blob/master/package.json)
- in app: **yes** (Can ship inside your app)
  > "license": "MIT"
  (https://github.com/amio/emoji.json/blob/master/package.json)

## Rules to follow
- The MIT license covers the package's JSON metadata and script, not any emoji artwork; the package ships no images.
- Keep the MIT notice (author Amio) when you redistribute the JSON files.
- The underlying emoji names and code points come from Unicode's emoji-test.txt under the Unicode license.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How to connect
- Package (npm/PyPI)
- npm: `npm install emoji.json`
- Repository: https://github.com/amio/emoji.json
- Website: https://github.com/amio/emoji.json

## Notes
License is stated only in package.json (MIT); the repo has no LICENSE file. Pure metadata: to show emoji you need a font or image set (e.g. Twemoji, Noto Emoji) with its own license. Caveat: No LICENSE text file in the repo; MIT copyright line not published, only the package.json field.

## Numbers (AgentGid data)
- Gid Score: 17
- GitHub stars: 303
- Downloads last week: 6,284

## Lines to paste into your prompt or AGENTS.md

```
- 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/)
```

## Links
- AgentGid page: https://agentgid.com/assets/emoji-json/
- Is it free for commercial use? https://agentgid.com/assets/emoji-json/commercial-use/
- Source: https://github.com/amio/emoji.json
- Source: https://github.com/amio/emoji.json/blob/master/package.json
- Source: https://www.npmjs.com/package/emoji.json
- Source: https://unicode.org/Public/emoji/latest/emoji-test.txt


## 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 to use it
- Emoji search by name: Let people type "cat" or "heart" and find the matching emoji, using the English names in the list. (idea, not from the official pages)
- Your own emoji picker tabs: Sort emoji into tabs like Smileys, Animals, Food and Flags with the group and subgroup that every entry carries. (idea, not from the official pages)
- 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: 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. (idea, not from the official pages)
- 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.

### How to start
- Install the package, or copy emoji.json into your project's static folder.

```
npm install emoji.json
```

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

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

- Pick an emoji image set or font for display, because the file holds only text.

### License
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.

### Good to know
- The project has no separate license file. The MIT license is named only in the package settings, and there is no copyright line to copy.
- The list has 5042 entries but only 3790 different names. Many emoji appear twice, with and without an invisible style mark, so remove repeats before showing them.
- The latest release, 16.0.0, is from July 2025 and covers Emoji 16. Newer emoji from later Unicode versions are not in it yet.
- Names are in English only. For names in other languages or search keywords, add another data set.
- The whole file is about 900 KB. Load it only on pages that need it, or use the short file with characters only.

Checked 2026-11-12 against: https://github.com/amio/emoji.json, https://github.com/amio/emoji.json/blob/master/README.md, https://github.com/amio/emoji.json/blob/master/package.json, https://github.com/amio/emoji.json/blob/master/scripts/gen.js, https://registry.npmjs.org/emoji.json, https://registry.npmjs.org/emoji.json/-/emoji.json-16.0.0.tgz, https://unicode.org/Public/emoji/latest/emoji-test.txt, https://www.unicode.org/license.txt

### Mistakes to avoid
- Don't: Showing every entry of emoji.json in a picker → Do: 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.)
- Don't: Filtering with e.category === 'Smileys & Emotion' as the README example suggests → Do: 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.)
- Don't: Linking https://unpkg.com/emoji.json/emoji.json in production → Do: 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.)
- Don't: Showing the 'Component' group as a picker tab → Do: 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.)

### 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.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
