• Create a custom emoji
• Get custom emoji for a group
• Set up the GraphiQL explorer

Use custom emoji with GraphQL

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

Parameters:

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 adding a custom emoji to the group, members can use it in the same way as other emoji in the comments.

Get custom emoji for a group

query GetCustomEmoji($groupPath: ID!) { group(fullPath: $groupPath) { id customEmoji { nodes { name } } } } 

Set up the GraphiQL explorer

This procedure presents a substantive example that you can copy and paste into GraphiQL explorer. GraphiQL explorer is available for:

• GitLab.com users at https://gitlab.com/-/graphql-explorer.
• Self-managed users at https://gitlab.example.com/-/graphql-explorer.

1. Copy the following code excerpt:

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

1. Open the GraphiQL explorer tool.
2. Paste the query listed above into the left window of your GraphiQL explorer tool.
3. Select Play to get the result shown here:

For more information on:

• GraphQL specific entities, such as Fragments and Interfaces, see the official GraphQL documentation.
• Individual attributes, see the GraphQL API Resources.