Managing emojis

Users can add custom emojis to create personalized and engaging content. For example, add icons to documentation for greater consistency, or upload logos to use as emojis in internal communications. Learn more about emojis

As a system or Confluence administrator:

By default, any logged-in user can upload emojis using the emoji menu in the editor.

Manage who can add an emoji

To enable users to add their own emojis:

  1. Administration  > General Configuration > Emojis
  2. Under Permissions, toggle the switch on to allow logged-in users to upload custom emojis

If the switch is off, only system or Confluence admins will be able to add custom emojis.

Delete uploaded emojis

To view and delete custom emojis uploaded to your Confluence site:

  1. Administration  > General Configuration > Emojis
  2. Under Manage custom emojis, find the emoji you want to delete
  3. Select Delete in the same table row
  4. You will receive a confirmation message, select Delete again

If the deleted emoji is in use on pages, blogs, or comments, it will be replaced by its text emoji shortcut.

You can also delete any custom emojis you've personally uploaded from the emoji menu in the editor.

Other emoji configurations

You can change these default emoji settings by configuring system properties.

SettingDefaultSystem property
File size1MBconfluence.emoticons.max.file.size
Site upload limit2000


Image resizes allowed in parallelThe maximum number of processors available to the virtual machine; never smaller than one



Last modified on Aug 9, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.