Apollo Client (Web)
Apollo Client (Web) - v4 (latest)
IntroductionWhy Apollo Client?Get started
Core concepts
QueriesSuspenseFragmentsMutationsTypeScriptRefetchingEvent-based refetchingSubscriptionsDirectivesError handlingPersisted queriesDocument transformsDeferring response dataBest practices
Caching
OverviewConfigurationReading and writingGarbage collection and evictionCustomizing field behaviorMemory ManagementAdvanced topics
Pagination
OverviewCore APIOffset-basedCursor-basedkeyArgs
Local State
OverviewLocal-only fieldsReactive variablesLocal resolvers
Development & Testing
Developer toolsGraphQL CodegenTesting React componentsSchema-driven testingMocking schema capabilitiesReducing bundle size
Performance
Improving performanceOptimistic mutation resultsServer-side renderingCompiling queries with Babel
Integrations
Using Apollo Client with your view layerNext.js App RouterReact Router framework modeTanStack StartIntegrating with React NativeLoading queries with Webpack
Networking
Basic HTTP networkingAdvanced HTTP networkingAuthentication
API Reference

Core

ApolloClientInMemoryCacheObservableQuery

Errors

CombinedGraphQLErrorsCombinedProtocolErrorsLinkErrorLocalStateErrorServerErrorServerParseErrorUnconventionalError

React

ApolloProvideruseQueryuseLazyQueryuseMutationuseSubscriptionuseFragmentuseApolloClientuseReactiveVaruseSuspenseQueryuseBackgroundQueryuseReadQueryuseLoadableQueryuseQueryRefHandlersskipTokencreateQueryPreloaderMockProviderSSR

Apollo Link

OverviewApolloLinkBaseHttpLinkBaseBatchHttpLinkBatchHttpLinkBatchLinkClientAwarenessLinkErrorLinkGraphQLWsLinkHttpLinkPersistedQueryLinkRemoveTypenameFromVariablesLinkRetryLinkSchemaLinkSetContextLinkWebSocketLink (deprecated)Community links
ChangelogMigrating to Apollo Client 4.0Versioning Policy
Products
Apollo GraphOS PlatformManage, observe, and scale your graph.Apollo ConnectorsConnect REST APIs to your graph declaratively.Apollo FederationFederate multiple subgraphs into a single supergraph.Rover CLIInteract with your graph from the command line.Apollo RouterRun and configure your graph gateway.Apollo OperatorDeploy and manage Apollo Router on Kubernetes.
Open source
Apollo Client (Web)Simplify GraphQL data management in web apps.Apollo iOSSwift-first GraphQL client for iOS.Apollo KotlinKotlin-first GraphQL client for Android and JVM.Apollo ServerBuild GraphQL servers with Node.js.Apollo MCP ServerExpose GraphQL tools to AI agents with MCP.IDE SupportEnhance your development workflow with IDE support.
Resources

Hooks (experimental)

Apollo Client experimental react hooks API reference

The latest minor version of Apollo Client has no experimental hooks. Please see the Hooks page for a list of available stable React hooks.