Emoji reactions
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
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:
- In the upper-right corner of the comment, select the smile ( ).
- 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:
- Select Add reaction ( ).
- Select the GitLab logo ( ) or scroll down to the Custom section.
- 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:
- On a description or a comment, select Add reaction ( ).
- At the bottom of the emoji picker, select Create new emoji.
- Enter a name and URL for the custom emoji.
- 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.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support