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

61 lines
1.8 KiB
Markdown
Raw Normal View History

# Add custom emoji
By default, anyone other than guests can add custom emoji to a Zulip organization. Added emoji
2018-07-18 17:39:02 +02:00
are available to all users.
Organization administrators can also
[change who can add custom emoji](/help/only-allow-admins-to-add-emoji).
## Add custom emoji
{start_tabs}
{settings_tab|emoji-settings}
2018-07-18 17:39:02 +02:00
1. Under **Add a new emoji**, enter an **emoji name**.
2018-08-06 15:23:16 +02:00
1. Click **Upload image or GIF** and add a file in the PNG, JPG, or
GIF file format. Zulip will automatically scale the image down to
25x25 pixels.
2018-07-18 17:39:02 +02:00
1. Click **Add emoji**.
{end_tabs}
2018-08-06 15:23:16 +02:00
**Emoji names** can only contain `a-z`, `0-9`, dashes (`-`), and spaces.
Upper and lower case letters are treated the same, and underscores (`_`)
are treated the same as spaces.
### Bulk add emoji
We expose a [REST API endpoint](/api/upload-custom-emoji) for bulk uploading
emoji. Using REST API endpoints requires some technical expertise; email
support@zulipchat.com if you get stuck.
2018-07-18 17:39:02 +02:00
## Replace a default emoji
2018-07-18 17:39:02 +02:00
You can replace a default emoji by adding a custom emoji of the same
name. If an emoji has several names, you must use the emoji's primary name
to replace it. You can find the primary name of an emoji by hovering over it
2018-09-17 00:58:31 +02:00
in the [emoji picker](/help/emoji-and-emoticons#select-from-the-emoji-picker),
while the search box is empty (you may have to scroll down a bit to find it).
## Delete custom emoji
{start_tabs}
2018-07-18 17:39:02 +02:00
{settings_tab|emoji-settings}
1. Click the trash icon (<i class="fa fa-trash-o"></i>) next to the
2018-08-06 15:23:16 +02:00
emoji that you would like to delete.
{end_tabs}
2018-07-18 17:39:02 +02:00
Deleting an emoji will not affect any existing messages or emoji
reactions. Anyone can delete custom emoji they added, and organization
administrators can delete anyone's custom emoji.
2018-07-18 17:39:02 +02:00
## Related articles
2018-07-18 17:39:02 +02:00
* [Change who can add custom emoji](/help/only-allow-admins-to-add-emoji)