Want to take your software engineering career to the next level? Join the mailing list for career tips & advice Click here


replace stuff like :heart: with <img> tags of corresponding images per: http://www.emoji-cheat-sheet.com/

Subscribe to updates I use emoji-images

Statistics on emoji-images

Number of watchers on Github 148
Number of open issues 7
Average time to close an issue 7 months
Main language JavaScript
Average time to merge a PR about 11 hours
Open pull requests 2+
Closed pull requests 0+
Last commit over 4 years ago
Repo Created about 7 years ago
Repo Last Updated over 2 years ago
Size 7.76 MB
Organization / Authorhenrikjoreteg
Page Updated
Do you use emoji-images? Leave a review!
View open issues (7)
View emoji-images activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
Evaluating emoji-images for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


Warnging: this repo not actively maintained, if you'd like to take over maintenance of it, let me know on this issue: https://github.com/HenrikJoreteg/emoji-images/issues/11 You may also want to check out this alternative: https://github.com/frissdiegurke/emoji-parser

Because sometimes you want to send a :heart: to someone.

What is this?

Takes text, replaces all the texts here: http://www.emoji-cheat-sheet.com with an <img> tag containing the image.

The images are all in the folder. Host those somewhere, pass the URL to the function. See below:

How to use it

var string = 'a string containing emoji strings like :heart: and :trollface:';

// the emoji function takes:
// 1. The input string
// 2. The url where the png files live
// 3. (optionally) a size to specify as the height of the <img> tag.
var emojified = emoji(string, 'http://url.com/where-you-put-the-pngs-folder/', 30); 

It's bundled to work as a CommonJS module, AMD module or expose itself as a global as a fallback.


Grab it here or on npm:

npm install emoji-images

Why not just use https://github.com/hassankhan/emojify.js?

I want it all in a super simple text processing (without the CSS and DOM stuff).

Also, that solution embeds pngs as data-uri's in css documents. I don't want to do that because then I have to send all that image data to the browser even if they never get used.

Is it ready to use?

Um... works for me (and in use on andbang.com)



emoji-images open issues Ask a question     (View All Issues)
  • over 4 years I'm not actively using this project currently, would love to add some more maintainers
  • almost 6 years Bower
  • almost 6 years :+1: does not work
  • over 6 years alt attribute with :name:
emoji-images open pull requests (View All Pulls)
  • add disappointed_relieved emoticon
  • Add colons to the alternative text as well
emoji-images questions on Stackoverflow (View All Questions)
  • How are the emoji images encoded in AndroidEmoji-htc.ttf file?
  • how can I check if my device is capable to render Emoji images correctly?
  • How to load thousands of emoji Images & GIF into iPhone app using web services
  • want to add images to textview similar to emoji images (default keyboard) in Xcode 6?
  • Corona SDK: show emoji/images on native.showAlert()
emoji-images list of languages used
Other projects in JavaScript