diff options
Diffstat (limited to 'doc/user/emoji_reactions.md')
-rw-r--r-- | doc/user/emoji_reactions.md | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/doc/user/emoji_reactions.md b/doc/user/emoji_reactions.md new file mode 100644 index 00000000000..1b2c1bcd2e5 --- /dev/null +++ b/doc/user/emoji_reactions.md @@ -0,0 +1,68 @@ +--- +stage: Plan +group: Project Management +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments +--- + +# Emoji reactions **(FREE ALL)** + +> - [Renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/409884) from "award emoji" to "emoji reactions" in GitLab 16.0. +> - Reacting with emoji on work items (such as tasks, objectives, and key results) [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/393599) in GitLab 16.0. +> - Reacting with emoji on design discussion comments [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/29756) in GitLab 16.2. + +When you're collaborating online, you get fewer opportunities for high-fives +and thumbs-ups. React with emoji on: + +- [Issues](project/issues/index.md). +- [Tasks](tasks.md). +- [Merge requests](project/merge_requests/index.md), +[snippets](snippets.md). +- [Epics](../user/group/epics/index.md). +- [Objectives and key results](okrs.md). +- Anywhere else you can have a comment thread. + +![Emoji reactions](img/award_emoji_select_v14_6.png) + +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](project/issues/sorting_issue_lists.md#sorting-by-popularity). + +For information on the relevant API, see [Emoji reactions API](../api/emoji_reactions.md). + +## 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 (**{slight-smile}**). +1. Select an emoji from the emoji picker. + +To remove an emoji reaction, select the emoji again. + +## Custom emoji + +> - [Introduced for GraphQL API](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/37911) in GitLab 13.6 [with a flag](../administration/feature_flags.md) named `custom_emoji`. Disabled by default. +> - Enabled on GitLab.com in GitLab 14.0. +> - UI to add emoji [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/333095) in GitLab 16.2. + +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** (**{slight-smile}**). +1. Select the GitLab logo (**{tanuki}**) or scroll down to the **Custom** section. +1. Select an emoji from the emoji picker. + +![Custom emoji in emoji picker](img/custom_emoji_reactions_v16_2.png) + +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](../api/graphql/custom_emoji.md). + +For a list of custom emoji available for GitLab.com, see +[the `custom_emoji` project](https://gitlab.com/custom_emoji/custom_emoji/-/tree/main/img). |