emoji

Published 2020-10-03. Last modified 2023-07-07.
Time to read: 1 minutes.

This page is part of the jekyll_plugins collection.

jekyll_emoji_tag defines a Jekyll tag called emoji that inserts an emoji of a given size and alignment.

Syntax

{% emoji OPTIONS %}

OPTIONS are:

align – left, right or inline (default is inline)
class – CSS class to apply to the generated emoji
div – Wriap the emoji in a <div> instead of a <span>.
emoji_and_name – causes the name of the emoji to be output along with the image (default is false)
list – output all emojis (default is false)
name – name of emoji (defaults to smiley)
size – height of emoji (defaults to 3em)
style – Additional CSS styles for the generated emoji

list and name are mutually exclusive; only specify one of them.

If neither list nor name is specified, the smiley emoji is output.

The names of all supported emojis are:

Shell

{% emoji %}

returns 😁

Shell

{% emoji name='angry' %}

returns 😠

Shell

{% emoji emoji_and_name name='boom' %}

returns 💥 boom

Shell

{% emoji name='grin' align='left' %}

returns 😀

Shell

{% emoji name='horns' size='1em' %}

returns 😈

Shell

{% emoji emoji_and_name list %}

returns

See the demo for more examples.

Add the following line to your Jekyll project's Gemfile, within the jekyll_plugins group:

Shell

group :jekyll_plugins do 
  gem 'jekyll_emoji_tag'
end

And then execute:

Shell

$ bundle