●Change8

Migrating to Apollo Client v3.14.0

Version v3.14.0 introduces 1 breaking change. This guide details how to update your code.

Released: 8/21/2025

1
Breaking Changes
6
Migration Steps
12
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

queryRef.toPromisepreloadQuery.toPromiseApolloClientInMemoryCache.addTypenameMockedProvider.addTypenamecanonizeResultsclient.queryobservableQuery.refetchclient.mutateclient.subscribecache.gcfield policies

Breaking Changes

●Issue #1

Removed `queryRef.toPromise()`; callers must replace it with `preloadQuery.toPromise(queryRef)`.

Migration Steps

  1. 1
    Replace all calls to `queryRef.toPromise()` with `preloadQuery.toPromise(queryRef)`.
  2. 2
    Review and update any usage of deprecated React Apollo APIs; consult deprecation warnings.
  3. 3
    Remove usage of `addTypename` in `InMemoryCache` and `MockedProvider` or switch to the new configuration.
  4. 4
    Stop using `canonizeResults`; migrate to the recommended alternatives.
  5. 5
    If you rely on `cache.gc()` resetting `addTypenameTransform` and `fragments` caches, ensure `resetResultCache` is set to `true` to retain previous behavior.
  6. 6
    Address any warnings about using `standby` fetch policy with `client.query`.

Release Summary

This minor release adds extensive deprecation warnings for APIs removed in Apollo Client 4.0 and introduces `preloadQuery.toPromise` as the new way to await preloaded queries, along with a fix for field‑policy merging.

Need More Details?

View the full release notes and all changes for Apollo Client v3.14.0.

View Full Changelog