EmojiOne™ is the open emoji standard. #iwantemojione
PHP CSS Python Java Swift Objective-C Other
Latest commit d56ef20 Nov 20, 2017
caseyahenson committed Nov 20, 2017 Merge pull request #562 from maximbaz/patch-1
Update setup instructions for Linux


EmojiOne Logo

npm version npm downloads

The web's first and only complete open source emoji set. It is 100% free for digital use and super easy to integrate.

What's Included?

  • This project includes libraries used to convert emoji into various formats, including conversion to EmojiOne emoji images.
  • All libraries included here are available free under the MIT license.

License to Use EmojiOne Images

EmojiOne Version 3

EmojiOne launched version 3.0 in 2017, which has several licensing options available. PNG 32px, 64px, and 128px as well as 32px and 64px sprites are available for digital use, with attribution. See emojione.com/developers/free-license for more information on usage and attribution requirements.

Premium Licenses are available for larger PNG assets and SVG assets, for digital and print use. See emojione.com/developers/premium-license for more information or to obtain a Premium License.

EmojiOne Version 2

EmojiOne version 2 assets (all SVG and PNG) are available in the 2.2.7 branch, and they remain available for digital use (with attribution) under the Creative Commons license. Please see INSTALLATION.md for instructions on installing version 2, and UPGRADE.md for instructions on upgrading from version 2 to version 3.


To install emojione, please refer to the guide at INSTALLATION.md. Version 3 introduces many potentially-breaking changes. Refer to the UPGRADE.md documentation for more details.


Please see CONTRIBUTING.md for more info on contributing to the emojione project. For artwork comments and questions please see the emojione-assets repo.


You'll find basic usage examples here in the /examples/ directory, and links to usage demos in USAGE.md.


Bug reports

If you discover any bugs, feel free to create an issue on GitHub. We also welcome the open-source community to contribute to the project by forking it and issuing pull requests.


If you have any questions, comments, or concerns you are welcome to contact us.


We sincerely hope that you choose to use EmojiOne and support our project, but if you feel like it's not for you, please have a look at these possible alternatives: