Conversion between emoji characters and their names.


Version on this page:0.1.2
LTS Haskell 21.12:0.1.3
Stackage Nightly 2023-09-22:0.1.3
Latest on Hackage:0.1.3

See all snapshots emojis appears in

BSD-3-Clause licensed by John MacFarlane
Maintained by jgm@berkeley.edu
This version can be pinned in stack with:emojis-0.1.2@sha256:3932d99972b998464beb4d67eddebeb00a21dab3e3b2d68bdb996e5cb0ccbc26,1909

Module documentation for 0.1.2


CI tests

This package provides functions for looking up an emoji by its name (alias), and for returning the aliases of an emoji.

A full list of (alias, emoji) pairs is also exported. In addition, a list of all emoji (including those without aliases) is exported, along with a list of all emoji formed using zero-width joiners.

Emoji aliases (emoji.json) are taken from the gemoji gem, used by GitHub. The full list of emoji are taken from the Unicode emoji specification files, (emoji-sequences.txt, emoji-zwj-sequences.txt). To regenerate these datafiles from the latest source, do make datafiles. If they have changed, do make to regenerate the emojis.inc file and rebuild the project.

This package has the following advantages over the emoji package on Hackage:

  • It supports a fuller range of emojis, including all those supported by GitHub
  • It supports lookup of emoji aliases from emoji
  • It uses Text rather than String
  • It has a lighter dependency footprint: in particular, it does not require aeson
  • It does not require TemplateHaskell




  • Initial release


  • Update emoji data.


  • Update emoji data (Unicode 14.0) and aliases from gemoji.
  • Export baseEmojis and zwjEmojis, generated directly from Unicode emoji data files, so that the library contains a complete list of emojis, including emojis for which gemoji provides no alias (Stephen Morgan).