GraphQL Docs
GraphQL Docs is a free, self-hosted web explorer for documenting GraphQL schemas.
What GraphQL Docs is
GraphQL Docs is a free, self-hosted web explorer for documenting GraphQL schemas. It focuses on presenting a schema overview rather than providing GraphiQL-style querying. The project supports dynamic documentation and static generation. Its command-line generator creates a static HTML documentation file from a schema file or GraphQL endpoint. The explorer renders Markdown descriptions and recursively follows types and fields reachable from the schema’s root query and mutation objects. Described field arguments appear in separate tables, while types that cannot be queried are excluded. A React component is available and requires a fetcher function that queries a server and returns a Promise. Installation is documented through npm, with minified files also available from GitHub releases. CSS is included in the JavaScript for its styling. Package metadata specifies Node.js 4.4.0 or higher and React and ReactDOM peer dependencies at version 15.0.1 or higher within the stated range. The repository uses the MIT license.
Good
- Free and self-hosted
- Supports dynamic and static documentation
- Generates static HTML from schemas or endpoints
- Renders Markdown descriptions
- Provides a React component
Watch out
- Does not include querying features
- Excludes types that cannot be queried
- React component requires a fetcher function
- Planned navigation and search remain listed features
Who it suits
It suits developers and teams who need self-hosted GraphQL schema documentation in dynamic or static form, without query execution features.
Verdict
GraphQL Docs provides focused schema exploration and static publishing for GraphQL projects. It is not a query tool, and its explorer omits unreachable types.
The facts
Each one read from GraphQL Docs's own pages, with the date it was checked.
What it does
- Dependencies
- The README says the CSS is included in the JavaScript code, so no other dependencies are required for that styling.checked 4 Oct 2026
- Documentation features
- The explorer renders Markdown documentation and recursively searches types and fields reachable from the schema’s root query and mutation objects.checked 4 Oct 2026
- Field arguments
- Field arguments with descriptions are listed in separate tables.checked 9 Oct 2026
- Installation
- The project can be installed from NPM as graphql-docs.checked 9 Oct 2026
- License
- The repository identifies its license as MIT.checked 9 Oct 2026
- Limit
- The project README says GraphQL Docs does not include querying features.checked 9 Oct 2026
- Notable limits
- Types that cannot be queried are excluded from the explorer.checked 4 Oct 2026
- Operating modes
- It supports dynamic and static documentation modes.checked 4 Oct 2026
- Package compatibility
- The package metadata specifies Node.js version 4.4.0 or higher and React and ReactDOM peer dependencies at version 15.0.1 or higher within the stated range.checked 4 Oct 2026
- Purpose
- GraphQL Docs is a documentation explorer for GraphQL schemas.checked 9 Oct 2026
- React component
- In dynamic mode, it exposes a React component that requires a function to run a query against a server and return a Promise.checked 9 Oct 2026
- Rendered descriptions
- Documentation is rendered as Markdown using Marked.checked 9 Oct 2026
- Schema overview
- It aims to provide a better overview of a schema than GraphiQL, without GraphiQL’s querying features.checked 9 Oct 2026
- Schema traversal
- It recursively searches types and fields reachable from the schema’s root query and mutation objects, excluding types that can’t be queried.checked 9 Oct 2026
- Scope
- The project says it aims to give a better schema overview than GraphiQL, without querying features.checked 4 Oct 2026
- Static generation
- The command-line generator can create a static HTML documentation file from a schema file or GraphQL endpoint.checked 4 Oct 2026
- Static output
- The command line generator can create a static HTML documentation file from a schema file or GraphQL endpoint.checked 9 Oct 2026
- Usage modes
- It supports dynamic and static documentation modes.checked 9 Oct 2026
The company
- Maker
- The package metadata names Magnus Hallin as the author.checked 4 Oct 2026
Money
- Planned features
- Improved navigation and on-page search are listed as planned features.checked 9 Oct 2026
Alternatives to GraphQL Docs
- 1

Mintlify
Free planWebAPILinuxmacOS8.0From $450 a month - 2
Fern
Free planOpen sourceWebAPILinuxmacOS7.8Free plan - 3

DocPlatform
Free planWebAPILinuxmacOS7.7From $29 a month - 4

VitePress
Free planOpen sourceWebAPILinuxmacOS7.7Free plan - 5

GitBook
Free planWebAPI7.6From $65 a month - 6

Documentation.AI
Free planWebAPI7.4From $55 a month
