Article version: Enterprise Server 2.14

This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2019-07-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Emoji on GitHub Pages

GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

You can use emoji within any Jekyll page or post, just like you would in a comment or issue within a repository on GitHub Enterprise.

Setting up

To enable emoji, you must add the following line to your site's _config.yml file:

  - jemoji

If you don't have a _config.yml file, you will need to create one in the root of your GitHub Pages repository. For more information, see Jekyll's official plugins documentation.


Use emoji within your Jekyll posts or pages as you would elsewhere on your GitHub Enterprise Server instance.

Testing locally

To preview the output of emoji locally:

Note: Emoji are currently only supported in the page and post body. Emoji within includes, layouts, and other sources of content may not render properly.

For more information, see The Jemoji Gem.

Ask a human

Can't find what you're looking for?

Contact us