Custom Emojis

This article details what custom emojis are and how to create, manage, use, and remove them.

What is it?

A custom emoji is a personalized icon that can be added to your Happeo. Unlike standard emojis, which are already integrated into the platform, custom emojis are created by users. 

The process of creating and using custom emojis is simple. Users can upload an image file, choose a name for the emoji, and save it. Once created, custom emojis can be used in various places, such as reactions to posts and comments.

Prerequisites

• You must be an Admin to upload and manage custom emojis
• For non-Admin users to be able to upload custom emojis, the Admin must allow all users to add custom emojis
  • This toggle can be found in the Admin Settings > Branding > Custom Emojis
• If no custom emojis have been created, the custom emoji tab in the emoji picker will not be available

Rules

Image file type

• Square images (20px x 20px)
• Image sizes under 128KB
• Images with transparent backgrounds work best
  • You can use image file types such as JPG, PNG, and GIF

What is allowed

• Numbers
• Letters (only lower case)
• _ symbol
• 30 characters maximum
• The Admin can replace images of custom emojis

What is supported

• Using custom emojis in:
  • Post reactions (desktop + mobile)
  • Comment reactions (desktop + mobile)

What is not supported

• Using custom emojis in:
  • Page Group or Page name
  • Channel name
  • User details
  • Post text
  • Article title
  • Article lead
  • Article text
  • Hashtags
  • Comment text

How to manage who can add custom emojis

As an Admin, to manage custom emojis, you can follow the steps below:

1. Navigate to the Admin Panel by clicking on your avatar and then Admin Settings
2. Click on Branding and then Custom Emojis
3. You can enable or disable all users from adding new custom emojis by toggling the toggle on or off at the top of the page

How to add a custom emoji

As an Admin, to add a custom emoji, you can follow the steps below:

1. Navigate to the Admin Panel by clicking on your avatar and then Admin Settings
2. Click on Branding and then Custom Emojis
3. Click Add Custom Emoji

As a regular user, to add a custom emoji, you can follow the steps below:

1. Navigate to a Post or comment and select the emoji picker
2. Type in what you want to name your new custom emoji
   1. Note: Your new custom emoji name cannot be an existing one
3. A button will appear titled Add custom emoji; click on it
4. Upload your custom emoji image
5. Title your custom emoji
6. Click Save

You can now find your new custom emoji in the custom emoji tab or by typing it in the emoji picker search bar or the post or comment section.

How to use a Custom Emoji

To use a custom emoji, please first make sure that a custom emoji(s) has been added. 

Post reactions

1. Navigate to a post and hover over the reaction button
2. Click on the three dots
3. Select the star symbol on the right of the emoji category navigation bar
   1. Alternatively, you can search by emoji name using the search bar in the emoji navigation bar
4. Click on any of the custom emojis to use them

Comment reactions

1. Navigate to a post comment and hover over the reaction button
2. Click on the three dots
3. Select the star symbol on the right of the emoji category navigation bar
   1. Alternatively, you can search for a custom emoji term using the search bar in the emoji navigation bar
4. Click on any of the custom emojis to use them

How to remove a Custom Emoji

As an Admin, to remove a custom emoji, you can follow the steps below:

1. Navigate to the Admin Panel by clicking on your avatar and then Admin Settings
2. Click on Branding and then Custom Emojis
3. Click the trash bin icon to remove custom emojis

What happens when a custom emoji is removed?

• The emoji will be deleted from the list of emojis in the Admin Settings
• The emoji will not be visible in the emoji picker for any user
• If an emoji was used to react to a post or comment and was deleted afterward, only the name of the emoji is going to be displayed in the reaction

Custom Emojis in Mobile Apps

Old Mobile App, iOS and Android

You can view custom emojis used in reactions on the old mobile app. However, you cannot use them yourself to react to posts and comments in this version. 

Additionally, creating new custom emojis is not currently supported through the app.

Beta - New Mobile App, iOS and Android

This version brings full support for custom emojis in reactions. You can:

• See them: View custom emojis used in reactions to posts and comments
• React with them: Add your own flair by using custom emojis in your reactions

To find them, you can open the emoji picker and look for the "custom emojis" section marked by a star icon.