PHPackages                             emojione/emojione - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. emojione/emojione

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

emojione/emojione
=================

EmojiOne is a complete set of emojis designed for the web. It includes libraries to easily convert unicode characters to shortnames (:smile:) and shortnames to our custom emoji images. PNG format provided for the emoji images.

4.5.0(7y ago)4.4k2.2M—2.2%520[103 issues](https://github.com/Ranks/emojione/issues)[14 PRs](https://github.com/Ranks/emojione/pulls)14(CC-BY-4.0 and MIT)PHPPHP &gt;=5.3

Since Sep 3Pushed 6y ago125 watchersCompare

[ Source](https://github.com/Ranks/emojione)[ Packagist](https://packagist.org/packages/emojione/emojione)[ Docs](http://www.emojione.com)[ RSS](/packages/emojione-emojione/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (51)Used By (14)

This repository is now maintained as JoyPixels/emoji-toolkit.
=============================================================

[](#this-repository-is-now-maintained-as-joypixelsemoji-toolkit)

You'll find the latest version of our resources at [emoji-toolkit](https://github.com/joypixels/emoji-toolkit). Please see the [UPGRADE README](https://github.com/joypixels/emoji-toolkit/blob/master/UPGRADE.md) for important information on what's changed from this repository. Thank you!

[![EmojiOne Logo](https://camo.githubusercontent.com/b05877e6820f8c98c3f68fa9fd48883c560f7dfaab28d7a7be6690b4c5cb9dd9/68747470733a2f2f7777772e656d6f6a696f6e652e636f6d2f696d616765732f766563746f72732f656d6f6a696f6e652d74797065666163652e737667)](https://camo.githubusercontent.com/b05877e6820f8c98c3f68fa9fd48883c560f7dfaab28d7a7be6690b4c5cb9dd9/68747470733a2f2f7777772e656d6f6a696f6e652e636f6d2f696d616765732f766563746f72732f656d6f6a696f6e652d74797065666163652e737667)
==================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#)

> [![npm version](https://camo.githubusercontent.com/061d1b70b669313fc4fd049ba4b62d5186d35ae10968d39e9f9df8fbe0d5801c/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f656d6f6a696f6e652e737667)](https://www.npmjs.com/package/emojione) [![npm downloads](https://camo.githubusercontent.com/0238f8067eb07f37077a7bfac618d8ee1e8d22b56a2dd447ccc7efed35198a6f/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f64742f656d6f6a696f6e652e737667)](https://www.npmjs.com/package/emojione) [![jsDelivr hits](https://camo.githubusercontent.com/7e94fe0d55a85457821ba22ecd88fb950f0234f37da6a8e32d55d49e3fd3202f/68747470733a2f2f646174612e6a7364656c6976722e636f6d2f76312f7061636b6167652f6e706d2f656d6f6a696f6e652f62616467653f7374796c653d726f756e646564)](https://www.jsdelivr.com/package/npm/emojione)

A set of libraries to help users find and replace native system emojis with EmojiOne in their app or website.

What's Included?
----------------

[](#whats-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
------------------------------

[](#license-to-use-emojione-images)

### EmojiOne Version 4

[](#emojione-version-4)

EmojiOne Version 4 is available under the same licensing structure as Version 3. Please see below for more details.

### EmojiOne Version 3+

[](#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  for more information on usage and attribution requirements.

*Premium Licenses are available for larger PNG assets and SVG assets, for digital and print use (within budget constraints).* See  for more information or to obtain a Premium License.

For product/retail licensing, visit .

### EmojiOne Version 2

[](#emojione-version-2)

EmojiOne version 2 is no longer supported or distributed. Please see [UPGRADE.md](UPGRADE.md) for instructions on upgrading from version 2 to version 3. Version 2 was bound by the [Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/).

Installation
------------

[](#installation)

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

Contributing
------------

[](#contributing)

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

Usage
-----

[](#usage)

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

Information
-----------

[](#information)

### Bug reports

[](#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.

-

### Contact

[](#contact)

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

- [![Gitter](https://camo.githubusercontent.com/abe08b740a4156153736f791393ec4da6619c4be73212e75769f52edacc0e2b5/68747470733a2f2f6261646765732e6769747465722e696d2f4a6f696e253230436861742e737667)](https://gitter.im/emojione/emojione?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
-
-
-

### Alternatives

[](#alternatives)

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:

-
-  (used to be known as [Phantom Open Emoji](https://github.com/Genshin/PhantomOpenEmoji))
-  (with [PHP](https://github.com/iamcal/php-emoji) and [Javascript](https://github.com/iamcal/js-emoji) interfaces)
-
-
-
-
-
-
-

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity71

Solid adoption and visibility

Community48

Growing community involvement

Maturity71

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~33 days

Recently: every ~61 days

Total

50

Last Release

2650d ago

Major Versions

v1.5.2 → v2.0.02015-12-17

v2.2.7 → v3.0.02017-04-19

3.1.7 → 4.0.02018-08-29

PHP version history (2 changes)v1.0.0PHP &gt;=5.0.0

v1.2.3PHP &gt;=5.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/83d4ce13e00be90f061b953bedd3250a307f31c3e7f0010ccdf89f779fd19292?d=identicon)[joypixels](/maintainers/joypixels)

---

Top Contributors

[![caseyahenson](https://avatars.githubusercontent.com/u/4519609?v=4)](https://github.com/caseyahenson "caseyahenson (141 commits)")[![emitxyz](https://avatars.githubusercontent.com/u/1959167?v=4)](https://github.com/emitxyz "emitxyz (86 commits)")[![Art4](https://avatars.githubusercontent.com/u/2162994?v=4)](https://github.com/Art4 "Art4 (32 commits)")[![mikebe11](https://avatars.githubusercontent.com/u/9707818?v=4)](https://github.com/mikebe11 "mikebe11 (23 commits)")[![JoshyPHP](https://avatars.githubusercontent.com/u/317712?v=4)](https://github.com/JoshyPHP "JoshyPHP (11 commits)")[![Zaszczyk](https://avatars.githubusercontent.com/u/7737337?v=4)](https://github.com/Zaszczyk "Zaszczyk (9 commits)")[![makario](https://avatars.githubusercontent.com/u/1217360?v=4)](https://github.com/makario "makario (7 commits)")[![kevinranks](https://avatars.githubusercontent.com/u/6843831?v=4)](https://github.com/kevinranks "kevinranks (7 commits)")[![miguelsousa](https://avatars.githubusercontent.com/u/2119742?v=4)](https://github.com/miguelsousa "miguelsousa (7 commits)")[![splendido](https://avatars.githubusercontent.com/u/6148980?v=4)](https://github.com/splendido "splendido (6 commits)")[![max-baz](https://avatars.githubusercontent.com/u/1177900?v=4)](https://github.com/max-baz "max-baz (5 commits)")[![ptbrown](https://avatars.githubusercontent.com/u/11481606?v=4)](https://github.com/ptbrown "ptbrown (5 commits)")[![sealionryan](https://avatars.githubusercontent.com/u/8646825?v=4)](https://github.com/sealionryan "sealionryan (4 commits)")[![marceloschmidt](https://avatars.githubusercontent.com/u/1986378?v=4)](https://github.com/marceloschmidt "marceloschmidt (4 commits)")[![rafaelks](https://avatars.githubusercontent.com/u/551004?v=4)](https://github.com/rafaelks "rafaelks (4 commits)")[![thinkrick](https://avatars.githubusercontent.com/u/8618431?v=4)](https://github.com/thinkrick "thinkrick (3 commits)")[![kavirajk](https://avatars.githubusercontent.com/u/3735252?v=4)](https://github.com/kavirajk "kavirajk (3 commits)")[![tm1000](https://avatars.githubusercontent.com/u/564256?v=4)](https://github.com/tm1000 "tm1000 (3 commits)")[![faytzel](https://avatars.githubusercontent.com/u/1248446?v=4)](https://github.com/faytzel "faytzel (3 commits)")[![dral3x](https://avatars.githubusercontent.com/u/447976?v=4)](https://github.com/dral3x "dral3x (2 commits)")

---

Tags

unicodeemojiemoticonsemojioneemojissmileyssmilies

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/emojione-emojione/health.svg)

```
[![Health](https://phpackages.com/badges/emojione-emojione/health.svg)](https://phpackages.com/packages/emojione-emojione)
```

###  Alternatives

[joypixels/emoji-toolkit

JoyPixels is a complete set of emoji designed for the web. The emoji-toolkit includes libraries to easily convert unicode characters to shortnames (:smile:) and shortnames to JoyPixels emoji images. PNG formats provided for the emoji images.

465817.1k7](/packages/joypixels-emoji-toolkit)[joypixels/assets

Emoji in png format brought to you by JoyPixels. JoyPixels is a complete set of emojis designed for the web. Licensing required: https://www.joypixels.com/licenses.

67117.9k](/packages/joypixels-assets)[emojitwo/emojitwo

Emojis in SVG and PNG format based upon Emojione. Emojitwo is a complete set of emojis (as of mid-2016: Unicode 9.0, Emoji 3.0) designed for the web.

3571.5k](/packages/emojitwo-emojitwo)[jawira/emoji-catalog

Get access to +3700 emojis as class constants

23436.4k](/packages/jawira-emoji-catalog)[nette/utils

🛠 Nette Utils: lightweight utilities for string &amp; array manipulation, image handling, safe JSON encoding/decoding, validation, slug or strong password generating etc.

2.1k394.3M1.5k](/packages/nette-utils)[christofferok/laravel-emojione

Laravel helper for EmojiOne

139115.8k](/packages/christofferok-laravel-emojione)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
