OpenMoji Jekyll Plugin
Bring beautiful OpenMoji emojis to your Jekyll websites.
OpenMoji is a free and open source emoji library which can be used for variety of purposes. it is licensed under CC BY-SA 4.0 .
If you are viewing this repository on GitHub, this GitHub repository is a mirror of the OpenMoji Jekyll Plugin, the main repository is served on GitLab, all developments and discussions, issue tracking and merge requests take place in GitLab.
This project is a fork of Jemoji. This project is currently independent from main OpenMoji project.
Enjoy a free open source emoji package
Use more than 3,000 emojis from OpenMoji package for free in your jekyll website. but remember to credit the OpenMoji project somewhere in your site to comply with their license.
Connect to any other emoji source
Use any available emoji package from a CDN or locally served emoji images by adding roughly 5 lines to your website's config file.
see a preview of how OpenMoji emojis looks like with this plugin at this page.
1. Add the following to your site's
2. Add the following to your site's
plugins: - jekyll-openmoji
3. Open terminal and use bundler to install this new gem.
4. Next steps
In any page or post, use emoji as you would normally, e.g.
I give this plugin two :+1:!
with this plugin, Jekyll will turn this markdown code
:+1: into this image:
to see all codes and their emoji images, see preview page.
If you'd like to serve emoji images locally, or use a custom emoji source,
you can specify so in your
emoji: # for other emoji packs providing a src key is required. # images will be served from this base address # it must be a valid URL, if you don't provide a string to src key # plugin will ignore this settings and uses default settings which # is OpenMoji emoji pack. src: "https://www.emojisource.com" # asset key is optional. # it will be appended to the end of src keyword to make a complete URL, # if you don't provide the asset value, it will be defaulted to "emoji". # you can also provide an empty string "" if your source doesn't have any asset path. asset: "/color/png" # final path will be "https://www.emojisource.com/color/png" and # emoji images will serve from this address. # in case of no asset value, final path would be "https://www.emojisource.com/color/svg/emoji" # MORE CONFIGURATION OPTIONS # all configs below are optional. # default emoji image extension is svg (vector file), but if your emoji source # images are in other formats, you can manually override default extension by using below key # and specify your desired extension (png, jpg, jpeg, bmp, etc). extension: "png" # you can also provide default inline css properties for emoji images with img_attrs # key, keep in mind that the keys must be valid css properties like padding, margin # height, width, etc. # below is a the default settings. img_attrs: class: "emoji" height: "20" width: "20"
How it works
For all sites emoji images are served from a GitHub.com CDN, with a
base URL of
https://cdn.jsdelivr.net/gh/azadeh-afzar/[email protected] and
asset path of
/images/color/svg, which results in emoji image URLs like
However you can alter the default path in
_config.yml to serve from external sources.
Emoji files names should be lowercase unicode strings, for example name of this emoji 😄 image file must be: 1f604
If you want to contribute to this project, please read CONTRIBUTING.
Code of Conduct
Visit the Code of Conduct.
Visit the Roadmap to keep track of which features we are currently working on.
Licensed under the GPLv3.