GraphQL Query Formatter

GraphQL is a query language for APIs developed by Meta. Instead of exposing many fixed endpoints, a GraphQL server exposes a single endpoint and a typed schema, and clients describe exactly the fields they need. The server returns only those fields, which avoids both over-fetching and the round trips that plague REST when a screen needs data from several resources.

A GraphQL document is hierarchical: selection sets nest with curly braces, arguments sit in parentheses, and variables are referenced with a leading $. Because whitespace is insignificant, a query that arrived minified from a build step or a network log can be hard to read. This formatter rewrites it with consistent indentation and line breaks so the structure is obvious at a glance.

The tool understands the full document grammar you are likely to use in practice: queries, mutations, subscriptions, and fragments, including variables, directives, aliases, inline fragments, and string arguments. It also supports the # comment syntax, which many editors omit.

Key features

• Format — re-indent a document with 2 or 4 spaces per level for readability.
• Minify — strip whitespace and comments to produce the smallest payload for production.
• Live stats — see character and line counts for both input and output.
• Copy and download — copy the result or save it as query.graphql.
• Private — tokenising and formatting happen in your browser; queries are never uploaded.

1. Paste the query — Paste or type a GraphQL document, or click Example to load a sample query, mutation, and fragment.
2. Choose an indent — Select 2 or 4 spaces per level.
3. Format or minify — Click Format to beautify, or Minify to compress.
4. Copy or download — Use Copy or download the result as a .graphql file.

The formatter is syntax-aware for layout but does not validate your schema. It will not detect unknown fields or type errors — use a GraphQL validator for that.

Format is for humans: it adds newlines and indentation so that nested selection sets are easy to follow, and it preserves comments. Minify is for machines: it removes every optional space and all comments, which shrinks the payload you send over the network.

A minified query and its formatted equivalent are semantically identical to a GraphQL server, which ignores insignificant whitespace. That makes minification a safe size optimisation, not a transformation of meaning.

# Formatted
query {
  users {
    id
    name
  }
}

# Minified
query{users{id name}}

• Debugging — reformat a query captured from a network tab or an error log so you can spot the missing field.
• Documentation — produce clean, readable examples for a README or an API guide.
• Code review — beautify a pasted query before discussing it with a teammate.
• Production payloads — minify a query string before embedding it in client code to save bytes.
• Learning — see how nesting, arguments, and fragments map to indentation.