--- title: "Manage Custom Sounds and Emojis in Rocket Chat" slug: "manage-custom-sounds-and-emojis" description: "Configure custom sounds and emojis in Rocket Chat. Personalise secure communications and improve user experience." updated: 2026-10-19T15:00:31Z published: 2026-10-19T15:00:31Z canonical: "docs.rocket.chat/manage-custom-sounds-and-emojis" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Manage Custom Sounds and Emojis Rocket.Chat provides various customization options to control the look and behavior of your workspace. These features are great personalization tools for your workspace. This document guides you through the custom sounds and emoji options. ## Manage custom sounds Rocket.Chat allows you to add sound files that can be used within your workspace. You can assign a chat activity to a particular sound. For example, select a sound to be played whenever you are added to a new room. ### Configure custom sound storage Before you add sound files, you can choose where to store the custom sounds uploaded. By default, GridFS within MongoDB is used. You can specify a valid storage path on your Rocket.Chat server if you prefer local storage. To configure this setting, go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Settings** > **Custom Sound Filesystem**. Update the following fields: | Field | Description | | --- | --- | | **Storage Type** | Select how you want to store sounds, either *GridFS* or *Filesystem.* - [**GridFS**](/v1/docs/recommendations-for-file-upload#gridfs) is the default storage system for custom sounds in Rocket.Chat. - **FileSystem** stores custom sounds directly on the local storage of the server running the Rocket.Chat instance. | | **System Path** | If you select **FileSystem** as the storage type, specify a valid path on the server hosting Rocket.Chat where custom sounds will be stored. For example, using `/sounds` will store your custom sounds in a `sounds` directory at the root level of your server. - For Docker deployments, access the Rocket.Chat server with `docker exec -it <container-name> sh` to verify the uploaded sounds. | Click **Save changes** once you are done. ### Add custom sounds Now that the storage is configured, you can upload custom sounds to your workspace. To add a new sound, follow these steps: 1. Go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Sounds**. 2. Click the **New** button at the top right. 3. Enter a name for your sound. 4. Upload a sound file in `mp3` format. 5. Click **Save**. After it is saved successfully, it is added to the list of sounds. ### Use the custom sounds After adding a sound, workspace users can select a chat activity to be associated with that sound. - See [Manage your sound settings](/v1/docs/manage-your-account-settings#sound) to know more about choosing sounds for chat activities in your workspace. - You can also personalize the sound of notifications in a channel. See [Manage notification preferences in rooms](/v1/docs/room-options#manage-notification-preferences) to learn how to use your sound for channel notifications. ### Edit and delete sounds Admins can modify existing custom sounds. On the **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Sounds** page, select the sound you want to edit or delete. Update the sound details and click **Save.** Click the **Delete** button to delete the sound. If you have many custom sounds, the list is paginated. Use the pagination controls at the bottom of the page to navigate between pages. --- ## Manage custom emojis Rocket.Chat allows you to add emoji files that can be used within Rocket.Chat workspace. Emojis are a great way of filling emotional cues. ### Configure custom emoji storage Before you add emoji files, you can choose where to store the custom emojis uploaded. By default, GridFS within MongoDB is used. You can specify a valid storage path on your Rocket.Chat server if you prefer local storage. To configure this setting, go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Settings** > **Custom Emoji Filesystem**. Update the following fields: | Field | Description | | --- | --- | | **Storage Type** | Select how you want to store emojis, either *GridFS* or *Filesystem.* - [GridFS](/v1/docs/recommendations-for-file-upload#gridfs) is the default storage system for custom emojis in Rocket.Chat. - **Filesystem** stores custom emojis directly on the local storage of the server running the Rocket.Chat instance. | | **System Path** | If you select *Filesystem* as the storage type, specify a valid path on the server hosting Rocket.Chat where custom emojis will be stored. For example, using `/emojis` will store your custom emojis in an `emojis` directory at the root level of your server. - For Docker deployments, access the Rocket.Chat server with `docker exec -it <container-name> sh` to verify the uploaded emojis. | Click **Save changes** once you are done. ### Add custom emojis Now that the storage is configured, you can upload custom emojis to your workspace. To add a new emoji, follow these steps: 1. Go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Emoji**. 2. Click the **New** button on the top right. 3. Enter a name for your emoji. 4. Enter an alias for your emoji. You can enter more than one alias as comma-separated values. 5. Browse and choose an image file in the `PNG` or `JPEG` format. 6. Click **Save**. ### Use the custom emojis To use an emoji that you've added, either click the emoji icon on the message input and search for your emoji by its name or enter `:emoji_name:` or `:emoji_alias:` in the message box to directly add the emoji. ### Edit and delete emojis Admins can modify existing custom emojis. On the **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Emoji** page, select the emoji you want to edit or delete. Update the emoji details and click **Save**. Click the **Delete** button to delete the emoji. If you have many custom emojis, the list is paginated. Use the pagination controls at the bottom of the table to navigate between pages. > [!NOTE] > - You can also manage custom assets using the [Custom Sounds API](https://developer.rocket.chat/apidocs/custom-sounds-api) and [Custom Emoji API](https://developer.rocket.chat/apidocs/custom-emoji-api) endpoints. > - Admins can disable emojis in the entire workspace from the [Accounts Settings](/v1/docs/accounts#set-default-user-preferences). Users can disable emojis on their own accounts from their [account settings](/v1/docs/manage-your-account-settings#messages). This will only affect the user’s account and not the entire workspace. > - When graphical emojis are disabled, emoji keywords and shortcuts display as regular text. > - Note that emoji reactions are available even when emojis are disabled. > [!CAUTION] > If you change the storage type, the previously uploaded files will not be available unless the changes are rolled back.