paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-11-04 22:13:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

user docs: Update add-custom-emoji.

Browse Source
This commit is contained in:
Lyla Fischer
2018-07-18 11:39:02 -04:00
committed by Rishi Gupta
parent 6e61152a53
commit c6938a42d6
3 changed files with 29 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
static/images/help/custom-emoji-demo.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 21 KiB

BIN
static/images/help/custom-emoji-success.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 39 KiB

56
templates/zerver/help/add-custom-emoji.md
View File

@@ -1,42 +1,44 @@
# Add custom emoji # Add custom emoji
If enabled by your Zulip organization administrator, you can add custom By default, anyone can add custom emoji to a Zulip organization. Added emoji
emojis to your organization for other members to use. are available to all users.
Organization administrators can also
[change who can add custom emoji](/help/only-allow-admins-to-add-emoji).
## Add a custom emoji
{settings_tab|emoji-settings} {settings_tab|emoji-settings}
5. In the green section labeled **Add a new emoji**, find the **Emoji name** and 1. Under **Add a new emoji**, enter an **emoji name**.
**Emoji URL** fields.
* In the **Emoji name** field, enter a phrase for your emoji. Only Emoji names can only contain `a-z`, `0-9`, dashes (`-`), and
alphanumeric characters, dashes, and underscores are allowed, spaces. Upper and lower case letters will be treated the same, and
but dashes and underscores cannot end an emoji phrase. underscores (`_`) will be treated the same as spaces.
Users will use the designated emoji phrase surrounded by 1. Click **Upload emoji** and add an image or GIF. The image will
colons to insert your emoji into their messages. automatically be scaled to 25x25 pixels.
* Click the **Upload emoji** button to upload and specify the image of your 1. Click **Add emoji**.
custom emoji.
Please note that the image will be scaled down to 25x25 pixels ## Replace a default emoji
in users' messages.
6. After filling out the **Emoji name** field and uploading the emoji image, You can replace a default emoji by adding a custom emoji of the same
click the **Add emoji** button to add your custom emoji to your name. If an emoji has several names, you must use the emoji's primary name
Zulip organization. to replace it. You can find the primary name of an emoji by hovering over it
in the [emoji picker](/help/add-emoji), while the search box is empty (you
may have to scroll down a bit to find it).
7. Upon clicking the **Add emoji** button, you will receive a notification ## Delete a custom emoji
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) {settings_tab|emoji-settings}
The emoji's information and settings will also be displayed above the 1. Click the trash icon next to the emoji that you would like to delete.
**Add a new emoji** section. You can also delete a custom emoji in
your organization through this panel by clicking the trash (<i
class="icon-vector-trash"></i>) icon to the right of the icon you wish to
delete.
Users in your organization can now use your emoji in their messages. 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.
![Custom emoji demo](/static/images/help/custom-emoji-demo.png) ## Related articles
* [Change who can add custom emoji](/help/only-allow-admins-to-add-emoji)