Download >

Mastodon

Are you an admin?

If you’re not an admin of your instance, you’ll need to ask your admin if they can add the emoji for you. Do you want to add all of the emoji, or some of them?

If you want to add some emoji, go to Option 1. If you want to add every emoji, go to Option 2.

Option 1 (some emoji)

1. Download and add 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

(Instructions accurate as of 2.3.0)

  1. Go to Settings.
  2. Go to the Administration Section.
  3. Go to Custom emojis.
  4. Scroll to the bottom and click the Upload button.
  5. Add the image and type the shortcode (usually the filename of what you’ve added).
  6. Click the Upload button to add it.
  7. Keep repeating to upload all the emoji as 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.

(Instructions accurate as of 2.3.0)

  1. Go to Settings.
  2. Go to the Administration Section.
  3. Go to Site Settings.
  4. Copy the text in the box below and paste it somewhere in your Instance Description.
  5. Scroll to the bottom and click Save Changes.
Copy + paste this:
<p>This instance uses <a href='https://mutant.tech'>Mutant Standard emoji</a>, which are licensed under a <a href='https://creativecommons.org/licenses/by-nc-sa/4.0/'>CC BY-NC-SA 4.0 International License</a>.</p>

Option 2 (all of the emoji)

If you’re good at scripting and want all of the emoji, there’s this specialised package just for that purpose:

Mutant Standard emojiMastodon package

There used to be a script that allowed you to automatically load all of the emoji and then hide them from the emoji picker, but it hasn’t been available for a long while and I don’t have it, but this package is still here if you want to make a new script! I’m sorry this is a bit of a weird guide!