25+ Queries

GraphQL Query, Mutation & Schema Cheat Sheet

The definitive GraphQL quick reference: query variables, field aliases, fragment reuse, @include/@skip directives, mutations, and cursor pagination with 1-click copy.

Queries & Arguments (3 commands)

Queries & Arguments

query GetUserProfile {
  user(id: "1042") {
    id
    name
    email
    avatarUrl
  }
}

Basic GraphQL query requesting specific fields for an entity without over-fetching.

PRO TIP Clients explicitly request only the fields needed by the active user interface view.

Queries & Arguments

query GetProducts($category: String!, $limit: Int = 10) {
  products(category: $category, limit: $limit) {
    title
    price
  }
}

Parameterized query with typed variables ($category: String!) and default values.

PRO TIP Exclamation mark denotes mandatory non-null parameters.

Queries & Arguments

query GetUsers {
  admins: users(role: "admin") { name }
  members: users(role: "member") { name }
}

Field aliasing allowing multiple queries with different arguments in a single request.

PRO TIP Avoids field name collisions in the JSON response payload.

Fragments & Directives (2 commands)

Fragments & Directives

fragment UserFields on User {
  id
  displayName
  role
  isVerified
}

Reusable field selection set shared across multiple queries and mutations.

PRO TIP Spread fragments inside query selection sets using ...UserFields syntax.

Fragments & Directives

query GetSettings($includeBeta: Boolean!) {
  settings {
    theme
    experimentalFeatures @include(if: $includeBeta)
    legacyMode @skip(if: $includeBeta)
  }
}

Conditional field inclusion using built-in @include and @skip directives.

PRO TIP Dynamically toggle fields based on feature flags or user role permissions.

Mutations (Writes) (2 commands)

Mutations (Writes)

mutation CreateArticle($input: ArticleInput!) {
  createArticle(input: $input) {
    id
    slug
    createdAt
  }
}

Executes a state-modifying write operation and returns specified fields of the new record.

PRO TIP GraphQL mutations run sequentially in declaration order to prevent race conditions.

Mutations (Writes)

mutation DeleteAccount($id: ID!) {
  deleteAccount(id: $id) {
    success
    message
  }
}

Deletes an entity record by unique identifier and returns a status payload receipt.

PRO TIP Returning an object rather than a boolean allows future extensible field additions.

Pagination & Types (3 commands)

Pagination & Types

query FeedWithCursor($first: Int, $after: String) {
  posts(first: $first, after: $after) {
    edges { cursor node { id title } }
    pageInfo { hasNextPage endCursor }
  }
}

Relay-specification cursor-based pagination query structure for infinite scrolling.

PRO TIP Cursor pagination avoids offset performance degradation in large database tables.

Pagination & Types

type Product {
  id: ID!
  title: String!
  price: Float!
  tags: [String!]!
  stock: Int
}

Schema Definition Language (SDL) object type with non-null constraints and lists.

PRO TIP [String!]! guarantees a non-null list where each individual element is also non-null.

Pagination & Types

enum RoleStatus {
  SUPERADMIN
  DEVELOPER
  READONLY
}

Enumeration type constraining input and response field values to specific options.

PRO TIP Enums validate inputs at the GraphQL parser layer before reaching resolvers.