●Change8

Migrating to GraphQL Yoga release-1757189660256

Version release-1757189660256 introduces 3 breaking changes. This guide details how to update your code.

Released: 9/6/2025

3
Breaking Changes
4
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

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

@graphql-yoga/apollo-link@graphql-yoga/urql-exchange@graphql-yoga/apollo-managed-federationgraphql-yoga

Breaking Changes

●Issue #1

Drop support for Node 18 in @graphql-yoga/apollo-link, @graphql-yoga/urql-exchange, and @graphql-yoga/apollo-managed-federation. Projects must upgrade to Node 20 or later.

●Issue #2

Drop support for Apollo Client v3 in @graphql-yoga/apollo-link; requires Apollo Client v4 or later.

●Issue #3

Require @urql/core v6 or later in @graphql-yoga/urql-exchange; older versions may break.

Migration Steps

  1. 1
    Update @apollo/client dependency to ^4.0.0 and adjust any Apollo Client v3 APIs.
  2. 2
    Update @urql/core dependency to ^6.0.0.
  3. 3
    Review peer dependency changes for @graphql-tools/executor-http, @graphql-tools/federation, @graphql-tools/utils, and @apollo/server-gateway-interface and update imports if needed.
  4. 4
    Reinstall packages after updating dependencies.

Release Summary

Version 5.0.0 of the Apollo Link and Urql Exchange packages upgrades runtime and peer dependencies, dropping Node 18 support and older client versions, while fixing a GraphiQL URL loader error.

Need More Details?

View the full release notes and all changes for GraphQL Yoga release-1757189660256.

View Full Changelog