GraphQL Syntax Cheat Sheet — Queries, Mutations & Fragments

Standard syntax for GraphQL operations, field selection, query variables, inline fragments, pagination, and directives.

Queries, Variables & Aliases

query GetUser($id: ID!) {
  user(id: $id) {
    id
    name
    email
  }
}

Named query with typed required variable ($id: ID!)

firstUser: user(id: "1") { name }
secondUser: user(id: "2") { name }

Field Aliases: fetch identical fields with differing arguments in a single query

fragment UserFields on User {
  id
  name
  role
}

Reusable field fragment included via ...UserFields spread

mutation CreatePost($input: PostInput!) {
  createPost(input: $input) {
    id
    title
  }
}

Execute state mutation and request newly created object fields back

avatarUrl @include(if: $withAvatar)

Directive: only include field in payload if condition boolean is true