Adding Emoticons to your GitHub Repository

I’ve often seen people using small graphic emoticons on their GitHub pages and quite fancied having some on mine, but never got round to actually doing it. That is, until that fateful night…tonight ­čÖé

Example of how emoticons can be used in GitHub.

An example

Luckily, it’s really easy and I can show you how.

First, let’s find a nice example. I still need one for a project I am working on called the PHPBookLibrary, so naturally, a book might fit. Here’s a┬ágood website which lists a whole host of example graphics.

The actual website.

If you scroll down, you will see this example and the code that you need to use. In my case, that’s “:blue_book:”.

Code for the blue book.

Emoticon code.

A nice touch on this website is that you can just click on the actual text code and it will be copied to your clipboard. Small features like that make the user experience so much better!

Next, go to the description in your GitHub repository because in this example, that’s where I am choosing to add one. It’s worth mentioning that it doesn’t need to be there – you can add these to comments, text files etc.; lots of places, really.

How to edit the details section.

Editing details.

Finally, place the text into the area you want it to go.

Showing what it looks like when you add the code into the details section.

Adding the emoticon code into the details section.

Save that and now step back to┬ámarvel at the loveliness ­čÖé

The final result.



Written by Stephen Moon
email: stephen at

Hey! Did you enjoy reading this? If you did and would like an email when I add new content, just subscribe to my list. You can unsubscribe at any time.

Leave a Reply

Your email address will not be published. Required fields are marked *