urql
urql.dev
- Free plan
- Web
- Browser extension
- API
What urql is
urql is a free, self-hosted GraphQL client for React, Preact, Vue, Solid, Svelte, or plain JavaScript applications. It sends declarative queries and mutations, manages caching and state, and provides an extensible connection to an API. Exchanges let developers customize fetching, caching, retries, authentication, subscriptions, and other request behavior. Documented exchanges include persisted queries, request policies, server-side rendering, and developer tools. urql uses document caching by default. Normalized caching is optional through the @urql/exchange-graphcache package, which can persist and restore cache state for offline use; that support is labeled experimental. Solid bindings include a createSubscription primitive, while subscriptions typically need WebSocket support and a subscription exchange. Browser extensions are available for debugging. The project describes urql as suitable for first GraphQL projects and complex apps. It is MIT-licensed, but first-party packages do not officially support batched queries.
Who it suits
urql suits developers building GraphQL applications with supported JavaScript frameworks or plain JavaScript. It can serve both an initial GraphQL project and more complex applications needing customizable exchanges.
Good to know, and what to watch
- Free and MIT licensed
- Bindings for major JavaScript frameworks
- Customizable exchange architecture
- Optional normalized caching
- Browser debugging extensions
- No official first-party batched queries
- Offline support is experimental
- Self-hosted deployment
The verdict
urql provides a flexible GraphQL client with framework bindings and configurable request behavior. Its document cache is straightforward, while Graphcache adds optional normalized and experimental offline capabilities.
What the maker publishes
- Available exchanges
- Documented exchanges include retry, persisted queries, authentication, request policy, server-side rendering, and devtools exchanges. source
- Client operations
- urql supports declarative GraphQL queries and mutations, caching and state management, and extensions for integrating with an API. source
- Compatibility limit
- The comparison page says urql does not officially support batched queries in its first-party packages. source
- Core capabilities
- urql sends GraphQL queries and mutations, manages caching and state, and provides an extensible integration point for an API. source
- Customizable behavior
- Exchanges let developers customize how requests are fetched, cached, retried, authenticated, and handled. source
- Customization
- Exchanges let developers customize how the client fetches, caches, and subscribes to data. source
- Default cache
- The default cache uses document caching; normalized caching is available as an opt-in through Graphcache. source
- Default caching
- The client uses document caching by default, and normalized caching is available through Graphcache. source
- Developer tools
- The project lists browser extensions for debugging urql. source
- Framework integrations
- The documentation describes bindings for React, Preact, Vue, and Svelte, and the comparison page also lists Next.js integration. source
- Framework packages
- The project describes bindings for React, Preact, Vue, Solid, and Svelte. source
- Graphcache
- Normalized caching is an opt-in feature provided by the @urql/exchange-graphcache package. source
- GraphQL integrations
- Documented exchanges include support for persisted queries, authentication flows, retries, file uploads, and subscriptions. source
- Intended users
- The project describes urql as suitable for both first GraphQL projects and more complex apps. source
- Intended users
- The documentation describes urql as a GraphQL client intended to start with minimal features and be extended as app needs grow. source
- License
- The repository lists an MIT license. source
- Notable limit
- The comparison page says urql does not support batched queries in its first-party packages. source
- Offline support
- Graphcache can persist and rehydrate cache state for offline use, and its documentation labels offline support experimental. source
- Project history
- The comparison page says urql's current architecture has existed since February 2019 and its normalized cache since September 2019. source
- Purpose
- urql is a customizable GraphQL client for React, Svelte, Vue, Solid, or plain JavaScript. source
- Subscriptions
- The Solid bindings provide a createSubscription primitive, and the guide says GraphQL subscriptions typically require WebSocket support and a subscription exchange. source
Checked against the maker's pages on 7 Oct 2026.