missive /emoji-mart

🏪 One component to pick them all

★ 9,395⑂ 905👁 39⑃ 374● 618▤ 39
TypeScriptMITCreated 2016-07-11missiveapp.com/open/emoji-mart
Download: v5.6.0v5.6.0 ↓5.6.02024-04-25
+0
Daily
9,395
stars
905
forks
39
watchers
374
prs
618
issues
39
releases

README

Emoji Mart is a customizableemoji picker HTML component for the web
  Demo
  
  
  Brought to you by the Missive team


 📖 Table of Contents
- 💾 Data
- 🏪 Picker
- 🙃 Emoji component
- 🕵️‍♀️ Headless search
- 🔬 Get emoji data from native
- 🗺 Internationalization
- 📚 Examples
- 🤓 Built for modern browsers
- 🛠 Development

 💾 Data

Data required for the picker to work has been completely decoupled from the library. That gives developers the flexibility to better control their app bundle size and let them choose how and when this data is loaded. Data can be:

 Bundled directly into your codebase
- Pros: Picker renders instantly, data is available offline
- Cons: Slower initial page load (bigger file to load)

sh
yarn add @emoji-mart/data


js
import data from '@emoji-mart/data'
import { Picker } from 'emoji-mart'

new Picker({ data })


 Fetched remotely
- Pros: Data fetched only when needed, does not affect your app bundle size
- Cons: Network latency, doesn’t work offline (unless you configure a ServiceWorker)

js
import { Picker } from 'emoji-mart'
new Picker({
  data: async () = {
    const response = await fetch(
      'https://cdn.jsdelivr.net/npm/@emoji-mart/data',
    )

    return response.json()
  }
})


In this example data is fetched from a content delivery network, but it could also be fetched from your own domain if you want to host the data.

 🏪 Picker
 React
sh
npm install --save emoji-mart @emoji-mart/data @emoji-mart/react


js
import data from '@emoji-mart/data'
import Picker from '@emoji-mart/react'

function App() {
  return (
    
  )
}


 Browser
html


  const pickerOptions = { onEmojiSelect: console.log }
  const picker = new EmojiMart.Picker(pickerOptions)

  document.body.appendChild(picker)



 Options / Props
| Option | Default | Choices | Description |
| ------ | ------- | ------- | ----------- |
| data | {} | | Data to use for the picker |
| i18n | {} | | Localization data to use for the picker |
| categories | [] | frequent, people, nature, foods, activity, places, objects, symbols, flags | Categories to show in the picker. Order is respected.  |
| custom | [] | | Custom emojis |
| onEmojiSelect | null | | Callback when an emoji is selected |
| onClickOutside | null | | Callback when a click outside of the picker happens |
| onAddCustomEmoji | null | | Callback when the Add custom emoji button is clicked. The button will only be displayed if this callback is provided. It is displayed when search returns no results. |
| autoFocus | false | | Whether the picker should automatically focus on the search input |
| categoryIcons | {} | | Custom category icons |
| dynamicWidth | false | | Whether the picker should calculate perLine dynamically based on the width of . When enabled, perLine is ignored |
| emojiButtonColors | [] | i.e. f00, pink, rgba(155,223,88,.7) | An array of color that affects the hover background color |
| emojiButtonRadius | 100% | i.e. 6px, 1em, 100% | The radius of the emoji buttons |
| emojiButtonSize |

Top issues

Discussions

Latest release

v5.6.0 v5.6.0 2024-04-25
🎉 New features
-  🫨 🫎 🪼 Emoji version 15.0 [844]

 🔨 Improvements
- Fix korean ISO code from kr to ko [841]

 ⚙️ Fixes
- matchMedia memory leak [868]

 🧑‍🎓 New Contributors
 @vemonet made their first contribution in https://github.com/missive/emoji-mart/pull/844
 @kyle-w-20230331 made their first contribution in https://github.com/missive/emoji-mart/pull/868

Full Changelog: https://github.com/missive/emoji-mart/compare/v5.5.2...v5.6.0

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON