GraphQL Linter

At a glance

• Editor score
  7.2 / 10
• Pricing
  Free plan
• Best for
  GraphQL teams wanting lightweight CI linting
• Free plan
  Yes
• Paid from
  Free
• OpenAPI linting
  No
• Facts checked
  14 Nov 2026

• Where it wins

  • Checks GraphQL schema syntax and design-rule findings.
  • Validates Apollo Federation directives.
  • Runs as a standalone Go binary without a Node.js toolchain.

• Where it doesn't

  • Limited to GraphQL schemas, not OpenAPI or AsyncAPI.
  • No user-defined custom lint rules.
  • Prebuilt binaries are available for Linux and macOS.

Our verdict on GraphQL Linter

GraphQL Linter is a command-line tool from Schuberg Philis for checking GraphQL SDL schema files, including .graphql and .graphqls files. It fits teams that want schema-focused linting in their development workflow, from smaller groups to enterprise teams. The tool checks syntax and design-rule findings, and validates Apollo Federation directives. Its focus is deliberately narrower than general API description linting, so teams that need OpenAPI or AsyncAPI linting should look at alternatives.

The workflow is suited to repositories that already use pre-commit or CI: GraphQL Linter can run as a pre-commit hook or in a CI pipeline, including through GitHub Actions. It can lint files together by directory and return a non-zero exit code when it finds issues, which supports automated checks. Distributed as a standalone Go binary, it avoids requiring a Node.js toolchain; prebuilt binaries are available for Linux and macOS, and installation with Go is also supported. This makes it a practical fit where a small, command-line check is preferred over a broader linting platform.

Configuration settings and finding suppressions let teams tune the checks and silence selected findings. The project is open source, and its published distribution is self-hosted rather than a hosted service. It does not support user-defined custom lint rules, so teams seeking to encode their own rule sets may prefer a more extensible linter. Choose GraphQL Linter for focused schema checks and Federation validation in existing hooks or pipelines; skip it if your requirements span API description formats or depend on custom rules.

Your product? Our editors can test GraphQL Linter in depth and publish a review, labelled as paid · from $149/mo →

GraphQL Linter pricing

GraphQL Linter fact sheet

GraphQL Linter integrations

GraphQL Linter lists 2 integrations on its own site.

• pre-commit
• GitHub Actions

Alternatives to GraphQL Linter

• SpectralA customizable JSON and YAML linter for teams enforcing OpenAPI and AsyncAPI standards.8.8
• ZZallyA focused OpenAPI linter with REST API, CLI, web UI, and configurable rules.7.9
• APIMaticAPI linting and validation alongside SDK, documentation and portal generation.7.9

See all GraphQL Linter alternatives →

Featured on iTechGuides

GraphQL Linter is listed in our API Linting Tools directory. Add the badge to your site — it links back to this page.

<a href="https://www.itechguides.com/products/graphql-linter/"><img src="https://www.itechguides.com/best/badge/graphql-linter.svg" alt="Featured on iTechGuides" width="230" height="46"></a>

Reviewed by iTechGuides Editors · Editorial team · Updated Nov 2026

Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.

Last updated 15 Nov 2026 · How we research and update