zulip/templates/zerver/help/add-custom-emoji.md

# Add custom emoji

If you are an administrator of a Zulip organization, you can add
custom emojis to your organization for other members to use.

{!go-to-the.md!} [Emoji Settings](/#administration/emoji-settings)
{!admin.md!}

5. In the green section labeled **Add a new emoji**, find the **Emoji name** and
**Emoji URL** fields.

    * In the **Emoji name** field, enter a phrase for your emoji. Only
      alphanumeric characters, dashes, and underscores are allowed,
      but dashes and underscores cannot end an emoji phrase.

        Users will use the designated emoji phrase surrounded by
        colons to insert your emoji into their messages.

    * In the **Emoji URL** field, insert the link to your custom
    emoji's image. The link must start with **http://** or
    **https://**.

        Please note that the image will be scaled down to 25x25 pixels
        in users' messages.

6. After filling out the **Emoji name** and **Emoji URL** fields,
click the blue **Add emoji** button to add your custom emoji to your
Zulip organization.

7. Upon clicking the **Add emoji** button, you will receive a notification
labeled **Custom emoji added!** in the **Add a new emoji** section, confirming
the success of the addition of your custom emoji to your organization.

    ![Custom emoji success](/static/images/help/custom-emoji-success.png)

    The emoji's information and settings will also be displayed above the
    **Add a new emoji** section. You can choose to delete any custom emojis in
    your organization through this panel.

8. Users in your organization can now use your emoji in their messages.

    ![Custom emoji demo](/static/images/help/custom-emoji-demo.png)