Logo
GitHubDiscord

urql

A highly customizable and versatile GraphQL client with which you add on features like normalized caching as you grow.

Type: client

Website: https://github.com/FormidableLabs/urql

Features

Feature Supported Since Note
MutationsJul 2015
QueriesJul 2015
SubscriptionsJun 2018
Repeatable DirectivesOct 2021
@specifiedByOct 2021
Directives on Variable DefinitionsOct 2021
Interfaces on InterfacesOct 2021
@oneOfSep 2025 N/A

urql does not perform schema validation or generate input object types; OneOf variables are sent as regular GraphQL variables.

Deprecated input valuesSep 2025
Executable documents descriptionsSep 2025 4.0.0

Since 4.0.0, urql relies on @0no-co/graphql.web, which supports executable definitions descriptions starting with 1.2.0 (changelog). Older urql versions depend on the installed graphql peer version.

'application/graphql-response+json' media typedraft 3.2.0

pr

'@defer'ExperimentalRFC2 2.3.0

Experimental multipart incremental delivery support for @defer and @stream was added in 2.3.0 (pr). The protocol was later updated in 3.2.0 (pr) and 4.1.4 (pr).

'@stream'ExperimentalRFC2 2.3.0

Experimental multipart incremental delivery support for @defer and @stream was added in 2.3.0 (pr). The protocol was later updated in 3.2.0 (pr) and 4.1.4 (pr).

Directives on directivesExperimentalRFC2 N/A

This is SDL syntax and does not apply to urql's executable operation handling.

Fragment ArgumentsExperimentalRFC2 -

Not supported by urql's built-in parser.

'onError' request parameterExperimentalRFC1 -

The built-in fetch request body does not include the GraphQL onError request parameter.

Deprecated objectsExperimentalRFC1 N/A

urql is not schema-aware and does not warn or typecheck deprecated object usage.

Service capabilitiesExperimentalRFC1 N/A

There is no built-in service-capabilities discovery/configuration in urql.

Field extensionsExperimentalRFC0 N/A

This is SDL syntax and does not apply to urql's executable operation handling.

@semanticNonNullExperimental N/A

urql does not perform schema-based type generation or nullability analysis.

Automatic Persisted QueriesExperimental ?

Know the status of this feature? Let us know!

HTTP batchingExperimental -

Explicitly unsupported by the built-in fetch implementation (source).

Persisted DocumentsExperimental ?

Know the status of this feature? Let us know!

Semantic IntrospectionExperimental N/A

Not applicable to urql's client runtime.