Use custom emoji with GraphQL

DETAILS: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Introduced in GitLab 13.6 with a flag named custom_emoji. Disabled by default.

Enabled on GitLab.com in GitLab 14.0.

Enabled on self-managed in GitLab 16.7.

Generally available in GitLab 16.9. Feature flag custom_emoji removed.

To use custom emoji in comments and descriptions, you can add them to a top-level group by using the GraphQL API.

Create a custom emoji

mutation CreateCustomEmoji($groupPath: ID!) {
  createCustomEmoji(input: {groupPath: $groupPath, name: "party-parrot", url: "https://cultofthepartyparrot.com/parrots/hd/parrot.gif"}) {
    clientMutationId
    customEmoji {
      name
    }
    errors
  }
}

After you add a custom emoji to the group, members can use it in the same way as other emoji in the comments.

Attributes

The query accepts these attributes:

Attribute	Type	Required	Description
`group_path`	integer/string	Yes	ID or URL-encoded path of the top-level group.
`name`	string	Yes	Name of the custom emoji.
`file`	string	Yes	URL of the custom emoji image.

Use GraphiQL

You can use GraphiQL to query the emoji for a group.

Open GraphiQL:
- For GitLab.com, use: https://gitlab.com/-/graphql-explorer
- For self-managed GitLab, use: https://gitlab.example.com/-/graphql-explorer

Copy the following text and paste it in the left window. In this query, gitlab-org is the group path.

    query GetCustomEmoji {
      group(fullPath: "gitlab-org") {
        id
        customEmoji {
          nodes {
            name,
            url
          }
        }
      }
    }

Select Play.

Use custom emoji with GraphQL

Create a custom emoji

Attributes

Use GraphiQL

Related topics