Emoji reactions

When you’re collaborating online, you get fewer opportunities for high-fives and thumbs-ups. React with emoji on:

• Issues.
• Tasks.
• Merge requests and snippets.
• Epics.
• Objectives and key results.
• Anywhere else you can have a comment thread.

Emoji reactions make it much easier to give and receive feedback without a long comment thread.

“Thumbs up” and “thumbs down” emoji are used to calculate an issue or merge request’s position when sorting by popularity.

For information on the relevant API, see Emoji reactions API.

Emoji reactions for comments

Emoji reactions can also be applied to individual comments when you want to celebrate an accomplishment or agree with an opinion.

To add an emoji reaction:

1. In the upper-right corner of the comment, select the smile ( ).
2. Select an emoji from the emoji picker.

To remove an emoji reaction, select the emoji again.

Custom emoji

Custom emoji show in the emoji picker everywhere you can react with emoji.

To add an emoji reaction to a comment or description:

1. Select Add reaction ( ).
2. Select the GitLab logo ( ) or scroll down to the Custom section.
3. Select an emoji from the emoji picker.

To use them in a text box, type the filename between two colons. For example, :thank-you:.

You can upload custom emoji to a GitLab instance with the GraphQL API. For more information, see Use custom emoji with GraphQL.

For a list of custom emoji available for GitLab.com, see the custom_emoji project.

Upload custom emoji to a group

Upload your custom emoji to a group to use them in all its subgroups and projects.

Prerequisites:

• You must at least have the developer role for the group.

To upload custom emoji:

1. On a description or a comment, select Add reaction ( ).
2. At the bottom of the emoji picker, select Create new emoji.
3. Enter a name and URL for the custom emoji.
4. Select Save.

You can also upload custom emoji to a GitLab instance with the GraphQL API. For more information, see Use custom emoji with GraphQL.