GitLab supports native Unicode emojis and falls back to image-based emojis selectively when your platform does not support it.

How to update Emojis

  1. Update the gemojione gem
  2. Update fixtures/emojis/index.json from Gemojione. In the future, we could grab the file directly from the gem. We should probably make a PR on the Gemojione project to get access to all emojis after being parsed or just a raw path to the json file itself.
  3. Ensure emoji-unicode-version is up to date with the latest version.
  4. Run bundle exec rake gemojione:aliases
  5. Run bundle exec rake gemojione:digests
  6. Run bundle exec rake gemojione:sprite
  7. Ensure new sprite sheets generated for 1x and 2x
    • app/assets/images/emoji.png
    • app/assets/images/emoji@2x.png
  8. Ensure you see new individual images copied into app/assets/images/emoji/
  9. Ensure you can see the new emojis and their aliases in the GitLab Flavored Markdown (GLFM) Autocomplete
  10. Ensure you can see the new emojis and their aliases in the award emoji menu
  11. You might need to add new emoji Unicode support checks and rules for platforms that do not support a certain emoji and we need to fallback to an image. See app/assets/javascripts/emoji/support/is_emoji_unicode_supported.js and app/assets/javascripts/emoji/support/unicode_support_map.js