Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time


A simple emoji map package that builds its data whenever it's installed.

This package maps the emoji codes (2049) or unicode () and sets them equal to its shortnames (["interrobang","exclamation_question"]).

The data generated by this package comes from emojibase-data, released under the MIT License.


const emojis = require('simple-emoji-map');

Or using ES6 imports:

import emojis from 'simple-emoji-map';


The JSON file is automatically generated on install.

To rebuild the JSON data file, it's a pretty simple process.

const build = require('simple-emoji-map/build');
// import build from 'simple-emoji-map/build';



To customize the build process, you will need either a .simple-emoji-map file or a simple-emoji-map property in package.json.

The shortcodes option selects which data set to use for the emoji codenames (see

The cldr and cldr-native values look to be supported in most languages (if not all), but the rest (emojibase, emojibase-legacy, github, etc) look to only exist for English.

  "lang": "en",
  "shortcodes": {
    "dataset": "emojibase",
    "lang": null,

    "fallbackDataset": null,
    "fallbackLang": null

  "shortnames": {},
  "type": "emoji", // or 'codepoint',
  "regex": null // regex for whitelist


This is also the way to add custom shortnames to the map file.

For example, if you want car to show the emoji for red_car (1f697), the file or property would look something like this:

    "shortnames": {
        "1f697": ["car"]

Keep in mind this will not replace any existing shortnames, only add to the emoji code's list.