The definitive source of the best
JavaScript libraries, frameworks, and plugins.

  • ×


    A Javascript module to convert Emoji keywords to images
    Filed under 

    • 🔾51%Overall
    • 1,799
    • 35 days
    • 🕩242
    • 👥12



    npm version Bower version MIT Licensed Gitter chat

    This project is currently unmaintained.

    Master Develop
    Master branch build status Develop branch build status
    Master branch Windows build status Develop branch Windows build status

    Browser Results

    A swiss-army-knife for all emoji, in Javascript. Used by Gitter and Mapbox.

    The emoji keywords are as described by

    Go to this project's GitHub pages to see the code in action.


    • Fast
    • Awesome
    • Converts emoticons like :) :( :'(
    • Allows customisation of processed emoji
    • Multiple modes; img, sprites and data-URI
    • Available on a CDN (gasp)
    • Includes a sample .htaccess file for caching Javascript and CSS
    • Switchable emoji sets (SOON!)
    • Made from unicorn blood


    Care about old browsers compatibility? Use

    Via cdnjs

    emojify.js is now available on cdnjs -

    Add this to the rest of your stylesheet imports:

    <link rel="stylesheet" href="//" />

    Then add this to your Javascript code:

    <script src="//"></script>

    Via Bower

    bower install emojify.js --save

    Via npm

    npm install emojify.js --save



    This works in the browser and on Node


    • object - Optional JSON object with any of the following attributes:
    Option Default Description
    blacklist.elements ['script', 'textarea', 'a', 'pre', 'code'] An array of elements you don't want emojified
    blacklist.classes ['no-emojify'] An array of classes you don't want emojified
    mode img By default, emojify will output an img with a src attribute for each emoji found. But if mode is set to sprite or data-uri, then spans with classes are outputted. Don't forget to include the appropriate CSS for your choice though, see the /dist directory.
    tag_type null When set, emojify uses this element with the class emoji emoji-#{emojiname} instead of an img with a src attribute. Example valid values: div, span. This takes precedence over the mode option. Note: if you're not using imgs, .emoji-+1 isn't a valid class, so .emoji-plus1 is used instead.
    only_crawl_id null [DEPRECATED] Restricts searching for emojis to a specified element & it's children. If null, and no object is passed to run(), document.body is used
    img_dir 'images/emoji' Defines the path to the emoji images
    ignore_emoticons false If true, only convert emoji like :smile: and ignore emoticons like :)


    emojify.setConfig({tag_type : 'div'});

    run([element], [replacer])

    This works in the browser and Node


    • element - Optional HTML element to restrict the emojification to.
    • replacer - Optional Function to override emoji replacement behaviour with your own. The function will receive two arguments, the emoji pattern found (emoji), and the emoji name (name). In the case of emoticons, for example, emoji = ':)' and name = 'smile'. Your function must return a HTMLElement.
    // OR'my-element'))
    // OR, function(emoji, emojiName){
      var span = document.createElement('span');
      span.className = 'emoji emoji-'  + emojiName;
      span.innerHTML = emoji + ' replaced';
      return span;

    Requires you to have jsdom installed: npm i jsdom --save

    var jsdom = require('jsdom')
        html: "<p><code>jhhh</code><em>:)</em></p>",
        done: function(errors, window) {

    replace(string, [callback])

    This works in the browser and on Node


    • string - String to emojify
    • callback - Optional callback function to output emoji with


    By default, emojify.js uses the internal function defaultReplacer() to replace emoji. You can override this behaviour by supplying your own callback function.

    Your callback function will receive two arguments, the emoji pattern found (emoji), and the emoji name (name). In the case of emoticons, for example, emoji = ':)' and name = 'smile'.

    The context in which your replacer function is run will have the config available. So you can access properties such as img_dir at this.config.img_dir.

    emojify.replace('I am happy :)');
    // OR
    replacer = function(emoji, name) {
        // Customise output here
        return emojifiedString;
    emojify.replace('I am happy :)', replacer);

    Contributing changes

    Please read



    Please read For image attributions, please read

    Show All