Download >

Discourse

Are you an admin?

If not, you’ll need to ask your forum admin if they can add the emoji for you.

1. Download and unzip the emoji

Download this emoji package:

Mutant Standard emojiShortcode, PNG 128px

Then unzip the download. If you’re on Windows or macOS, you should be able to do that just by double-clicking the .zip file.

2. Add the emoji to your server

(Instructions accurate as of 1.9.0beta14)

  1. Go to admin settings.
  2. Go to Customise.
  3. Go to the Emoji subsection.
  4. Drag and drop the emoji directly into the page if you don’t need to change the shortcode. If you do, enter the shortcode in the box at the top first, then press the Add New Emoji button to add the image.
  5. Keep repeating to upload whatever emoji you want.

Be aware that some of the filenames may overlap with emoji that already exist. If you find that they do that, consider adding ms_ to the beginning of the shortcode you give to the emoji when importing.

3. Attribute

Attributing is a legal requirement, but it’s also generally cool because every designer deserves credit, and it helps people find the project! Don’t worry, it’s really easy.

Copy the text in the box below and paste it somewhere in your forum’s FAQ page.

Copy + paste this:
This forum uses [Mutant Standard emoji](https://mutant.tech), which are licensed under a [CC BY-NC-SA 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/).