diff options
Diffstat (limited to 'doc/user/award_emojis.md')
-rw-r--r-- | doc/user/award_emojis.md | 48 |
1 files changed, 26 insertions, 22 deletions
diff --git a/doc/user/award_emojis.md b/doc/user/award_emojis.md index c3aad86461b..aaba0225653 100644 --- a/doc/user/award_emojis.md +++ b/doc/user/award_emojis.md @@ -6,11 +6,12 @@ info: To determine the technical writer assigned to the Stage/Group associated w # Emoji reactions **(FREE)** -> - [Renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/409884) from "award emojis" to "emoji reactions" in GitLab 16.0. -> - Reacting with emojis on work items (such as tasks, objectives, and key results) [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/393599) in GitLab 16.0. +> - [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 emojis on: +and thumbs-ups. React with emoji on: - [Issues](project/issues/index.md). - [Tasks](tasks.md). @@ -25,19 +26,10 @@ and thumbs-ups. React with emojis on: Emoji reactions make it much easier to give and receive feedback without a long comment thread. -For information on the relevant API, see [Emoji reactions API](../api/award_emoji.md). - -## Sort issues and merge requests on vote count - -You can quickly sort issues and merge requests by the number of votes ("thumbs up" and "thumbs down" emoji) they -have received. The sort options can be found in the dropdown list as "Most -popular" and "Least popular". +"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). -![Votes sort options](img/award_emoji_votes_sort_options.png) - -The total number of votes is not summed up. An issue with 18 upvotes and 5 -downvotes is considered more popular than an issue with 17 upvotes and no -downvotes. +For information on the relevant API, see [Emoji reactions API](../api/award_emoji.md). ## Emoji reactions for comments @@ -51,14 +43,26 @@ To add an emoji reaction: To remove an emoji reaction, select the emoji again. -## Custom emojis +## 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. +> - [Added](https://gitlab.com/gitlab-org/gitlab/-/issues/333095) UI to add emoji 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) -You can upload custom emojis to a GitLab instance with the GraphQL API. -For more information, see [Use custom emojis with GraphQL](../api/graphql/custom_emoji.md). +To use them in a text box, type the filename between two colons. +For example, `:thank-you:`. -Custom emojis don't show in the emoji picker. -To use them in a text box, type the filename without the extension and surrounded by colons. -For example, for a file named `thank-you.png`, type `: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 emojis available for GitLab.com, see +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). |