This is Emoji Rodeo

Imagine Slack's reactions had an adorable baby with Facebook's Like button that you could put on your own website. Well, imagine no more!

Sign up and place our JavaScript on your site, and we'll give you just that. People will be able to respond to your blog post with one of 1,600 emoji. Pretty great, I think you'll agree.

How does it work?

The Embed

Our aim is simplicity. We want to make this as simple as possible for site owners to install, and for your users to use. All you need to do is sign up, tell us which domains you're going to be using your code on, then install the code on your site. As soon as the code shows on your site, you're done. All your users need to do is choose from our glorious emoji to associate with your content.


We've done everything we know how to make this thing load quickly, and with minimal data use for your users, but the fact is, when you need them you're going to be loading around 1,600 images. We gzip and cache everything we send to the browser as much as we possibly can.

We don't load anything blocking on initial load. When Emoji Rodeo scrolls into view, we load the bare minimum, which is the emoji assigned to that URL and the assets needed to load everything else if necessary. It's only when they open the picker that we load everything else, and that's all loaded from cache after the first time. However, there's no getting around the fact that there's an initial download of 1.5MB for all those emoji. Hopefully that won't be a problem for you, but we'd rather you heard it from us first.


We use cookies in three locations - a session cookie when you log in on this site, a session cookie for your users to help us identify potential spam patterns and remove them, and a session cookie to remember your users' skin tone selection. We don't hold any information that would identify your users, and we don't currently have any intention of gaining this information. Your users remain anonymous to us and to you. If this changes in future, we will contact you to let you know and give you the opportunity to opt out, but we think it's important to tell you now so that you can pass this information on to your users if you choose to. Honestly, though; cookies are mostly not harmful so we're pretty sure you probably don't even care.

What does it do?

Right now we're aiming for IE9+ support. If you notice a bug, please let us know when/where/how and we'll do our best to fix it. When things fail, they do so silently, so your users aren't going to see a load of scary messages about broken things. They'll just see nothing.


Right now, you can change all the language used throughout the embed so that it matches the tone and language of your site.

You can also maintain a blacklist of query string parameters that won't be used to differentiate your URL. We currently strip all utm_* codes from your URL so that referrals from Google, Twitter, Facebook etc. don't count as separate URLs, but we don't know everything, so you can add to this if you need to. And if you're feeling super generous, you could tell us what you've blocked and maybe we'll add it to core.


We currently have two themes - one completely minimal one, and one that's inspired by Slack. But you don't have to use either of those. Our CSS has a sensible naming convention so that you can create your own themes and make the whole thing look your own. We hate having other company logos on our site, so we don't do that to you. It's your site, and it should stay that way. If you want to give us a shout out from your Twitter or Facebook, though, we'd like that a lot.


We've included a long list of events into which you can hook to add custom behaviour to the plugin. More to come later in our developer documentation.