GraphiQL
graphiql.dev
- Free plan
- Web
- Self-hosted
What GraphiQL is
GraphiQL is a free, interactive, in-browser IDE for working with GraphQL. It supports the latest GraphQL specification, with syntax highlighting, type-aware suggestions, query and variable completion, and error reporting. Its documentation explorer supports search and Markdown, while built-in query history and documentation explorer features are available as plugins. GraphiQL can save state in localStorage, and its plugin API allows interface extensions. It is also a React package for embedding the IDE in an application; a component requires a fetcher function that sends requests to a GraphQL API. The toolkit fetcher supports HTTP, multipart incremental delivery, and subscriptions through graphql-ws or the legacy WebSocket protocol. Developers can customize the interface with React props and children, and CSS variables are the supported way to change appearance. The project provides an installable progressive web app demo and examples for CDN, Webpack, Create React App, and Parcel. The code is open source under the MIT license. GraphiQL targets modern browsers and does not support Internet Explorer or older evergreen browser versions. Its class names may change between minor or patch releases.
Who it suits
GraphiQL suits developers who want an in-browser GraphQL IDE or a React package to embed in an application. It is also relevant to teams using the listed bundlers, transports, and GraphQL tooling integrations.
Good to know, and what to watch
- Supports the latest GraphQL specification.
- Documentation explorer supports search and Markdown.
- Plugin API includes query history and documentation tools.
- Toolkit fetcher supports HTTP and WebSocket subscriptions.
- Open source under the MIT license.
- Does not support Internet Explorer or older evergreen browsers.
- A React integration requires a fetcher function.
- Class names may change between minor or patch releases.
- React, React DOM, and GraphQL are peer dependencies.
Plans
Every plan and priceGraphiQL
Free plan
Getting started
- Open the GraphiQL website or progressive web app demo
- Install React, React DOM, and GraphQL as peer dependencies
- Install GraphiQL as a React package
- Provide a fetcher function connected to your GraphQL API
- Choose HTTP, multipart delivery, or WebSocket subscription transport
- Customize the interface with React props, children, or CSS variables
The Club's review
GraphiQL is an interactive GraphQL IDE that runs in a browser and can also be embedded through a React package. It is aimed at developers and teams working directly with GraphQL schemas who want a capable editor without subscription charges. The main appeal is schema-aware authoring and documentation in an MIT-licensed package; the main compromises are integration work, modern-browser requirements, and limited freedom to depend on internal CSS class names.
Overview
GraphiQL provides a browser workspace for composing, inspecting, and sending GraphQL operations. The project includes an installable progressive web app demonstration and examples for CDN ESM, Webpack, Create React App, and Parcel deployments. Its React form is more useful when you are building an internal tool or product feature than when you simply want a standalone API client: your application must provide a fetcher that connects the component to a GraphQL API.
The code is open source under the MIT license, so it can be used in commercial or private projects without a subscription or seat charges. That freedom also means the deploying team owns the surrounding application, API connection, and operational decisions.
Key features
Schema-aware query editing
Support for the latest GraphQL specification combines syntax highlighting, type-ahead suggestions, type-aware query completion, variable completion, and real-time error highlighting. In practice, this helps developers discover fields and arguments while writing and catch malformed operations before sending them. It is particularly valuable for people learning an unfamiliar schema, while experienced users benefit from faster navigation without leaving the editor.
Documentation and state
The documentation explorer includes search and Markdown support, keeping schema reference close to the query. Built-in documentation explorer and query history plugins cover the common navigation and recall tasks, and the plugin API allows additional extensions. GraphiQL stores state in localStorage, which is convenient when returning to work in the same browser but ties that continuity to the browser's local data.
Embedding and transport
React props and children provide supported ways to shape an embedded interface, while CSS variables are the recommended styling mechanism. Class names are not stable across minor or patch releases, so custom CSS that targets them can require maintenance. The component needs React, React DOM, GraphQL, and a fetcher function; that fetcher may return promises, observables, or async iterables. The toolkit fetcher handles HTTP, multipart incremental delivery, and subscriptions through graphql-ws or the legacy WebSocket protocol.
Pricing
| Plan | Price | What it includes |
|---|---|---|
| GraphiQL | Free | MIT-licensed open-source project distributed as a package for React applications |
There are no paid tiers, quotas, seat limits, trials, or renewal terms to weigh. The free package suits individual developers, internal teams, and product builders who can supply and maintain their own API connection. It does not remove the engineering work of embedding the component or operating a deployment.
Platforms
GraphiQL is available on the web and as a self-hosted deployment. Its browser bundle targets modern browsers and does not support Internet Explorer or older evergreen browser versions. Teams standardizing on legacy browsers should look elsewhere or isolate GraphiQL to a supported environment.
Who it's for
Choose GraphiQL when your work is GraphQL-first and you want completion, live validation, searchable schema documentation, and an embeddable React interface. It fits developers building internal consoles, documentation-oriented tools, or custom browser experiences, especially when MIT licensing and zero usage fees matter.
It is less suitable for users who expect a finished API client with no fetcher or React setup, or for organizations that must support older browsers. It is also a poor fit for teams whose visual customization depends on stable DOM class names rather than CSS variables and supported React interfaces.
Pros and cons
Pros
- Strong GraphQL authoring: specification-aware completion, suggestions, and immediate errors reduce mistakes during query construction.
- Documentation in context: searchable Markdown documentation and a built-in explorer keep schema reference beside the editor.
- Flexible embedding: React integration, plugins, and a fetcher abstraction support custom products and multiple transport patterns.
- No licensing bill: the MIT license and free package work for commercial and private use without per-seat pricing.
Cons
- Requires integration: the React component needs peer dependencies and a fetcher that performs API requests, so it is not a zero-setup client.
- Modern browser boundary: Internet Explorer and older evergreen browsers are unsupported.
- Fragile class-based styling: class names can change between minor or patch releases; CSS variables are the supported customization path.
- Security maintenance matters: versions 0.5.0 through 1.4.6 had a reported XSS vulnerability, with 1.4.7 identified as patched.
Alternatives
For a broader set of GraphQL tooling, browse GraphQL Tools; for general-purpose request and testing software, see API clients.
- GraphQL Hive is a free, web, API, and self-hosted option with a Hobby plan billed free forever, including 1M operations per month and 7-day usage-data retention.
- Altair GraphQL Client is the better direction when you want a freemium client spanning browser extensions, desktop platforms, and web rather than an embeddable React package.
- Apollo Studio suits teams seeking a freemium GraphQL platform with a free tier for up to three developers, a 60-request-per-minute router limit, and one-day data retention.
- Apollo Client is an alternative when the priority is a client library across Android, iOS, web, and extension environments.
- Hasura fits teams wanting a broader API platform; its free tier allows two databases per project, 100MB of data passthrough monthly, and up to 3M API requests monthly.
- Hot Chocolate is a free MIT-licensed choice for building GraphQL services rather than editing queries in a browser IDE.
- PostGraphile is an alternative for generating GraphQL APIs from PostgreSQL.
- GraphQL Ruby is aimed at Ruby developers implementing GraphQL servers, with a free gem and a separate paid Pro offering.
Verdict
GraphiQL is a strong choice for developers who want a free, MIT-licensed GraphQL editor with completion, live validation, searchable documentation, and React embedding. Choose it when you control the integration and can target modern browsers. Look elsewhere for a turnkey client, legacy-browser support, or styling that depends on stable class names.
The verdict
GraphiQL offers query editing and documentation features in a free browser IDE, with a React package for embedding it. Check browser requirements and avoid relying on stable class names when customizing the interface.
Questions people ask
Is GraphiQL free?
Yes. The listed GraphiQL plan costs nothing, and the project is MIT-licensed open source.
Which platforms does GraphiQL support?
It is available on the web and can be self-hosted. Its browser bundle targets modern browsers and does not support Internet Explorer.
Can GraphiQL connect to subscriptions?
Yes. The toolkit fetcher supports subscriptions through graphql-ws or the legacy WebSocket protocol, as well as HTTP and multipart incremental delivery.
What does a React integration require?
A GraphiQL component requires a fetcher function that performs requests to a GraphQL API. The fetcher can support promises, observables, or async iterables.
Can the interface be extended?
Yes. GraphiQL provides a plugin API, and its appearance can be customized with React props, children, and CSS variables.
What the maker publishes
- API connection
- A GraphiQL component requires a fetcher function that performs requests to a GraphQL API and can support promises, observables, or async iterables. source
- Browser support
- The repository says its browser bundle targets modern browsers and does not support Internet Explorer or older evergreen browser versions. source
- Customization
- The UI can be customized with React props and children, and CSS variables are the officially supported way to customize its appearance. source
- Customization limit
- The README says GraphiQL class names are not stable and may change between minor or patch releases. source
- Deployment
- The project provides an installable progressive web app demo and examples for CDN, Webpack, Create React App, and Parcel. source
- Documentation
- Its documentation explorer supports search and Markdown. source
- Documentation explorer
- Its documentation explorer supports search and Markdown. source
- Free plan
- Yes source
- GraphQL support
- Yes source
- Installation
- The package installation instructions list React, React DOM, and GraphQL as peer dependencies. source
- Integration
- GraphiQL is a React package that requires a fetcher function to send requests to a GraphQL API. source
- Integrations
- The project provides examples for CDN ESM, Webpack, Create React App, and Parcel, and its repository describes GraphQL language tooling for CodeMirror, Monaco, and Visual Studio Code. source
- Language support
- It supports the latest GraphQL specification with syntax highlighting, type-ahead suggestions, error reporting, and automatic query and variable completion. source
- License
- The GraphiQL repository describes the code as open source under the MIT license. source
- Available platforms
- web source
- Plugins
- GraphiQL has a plugin API, with built-in documentation explorer and query history plugins. source
- Purpose
- GraphiQL is an interactive, in-browser IDE for GraphQL. source
- Purpose
- GraphiQL is an interactive, in-browser IDE for GraphQL. source
- Query editing
- It supports GraphQL syntax highlighting, type-aware suggestions, query and variable completion, and real-time error highlighting. source
- Saved state
- GraphiQL persists state using localStorage. source
- Security
- A 2021 advisory reports an XSS vulnerability in GraphiQL versions 0.5.0 through 1.4.6 and identifies 1.4.7 as patched. source
- Security
- The project warns that GraphiQL versions below 1.4.7 are vulnerable to an XSS attack when connected to an untrusted GraphQL server. source
- Support
- The project directs users to GitHub for issues and discussions and to the GraphQL Discord server for community discussion. source
- Transport support
- The toolkit fetcher supports HTTP, multipart incremental delivery, and subscriptions through graphql-ws or the legacy WebSocket protocol. source
Checked against the maker's pages on 7 Oct 2026.