# 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.

1. Click the cog (![cog](/static/images/help/cog.png)) in the upper right corner
of the right sidebar.

2. Select **Administration** from the dropdown menu that appears.

    ![Administration dropdown](/static/images/help/administration.png)

3. Upon clicking **Administration**, your view will be replaced with the
**Administration** page. You will be located on the **Organization settings**
tab by default.

    ![Administration page](/static/images/help/admin-window.png)

4. Scroll down to the **Custom emoji** section located beneath the
**Organization settings** section.

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

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.

        ![Emoji name](/static/images/help/emoji-name.png)

        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://**.

        ![Emoji URL](/static/images/help/emoji-url.png)

        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.

    ![Add emoji](/static/images/help/add-emoji.png)

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)