npm / @graphql-tools/schema
@graphql-tools/schema
What changed in @graphql-tools/schema 8 to 11, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-13.
10 breaking1 deprecations2 new APIs and options1 behavior and defaults3 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@graphql-tools/schema 114 changes
Breaking changes 2
GraphQL v14 and v15 are no longer supported; the peer range is now ^16.0.0 || ^17.0.0.
Node.js >=22.18.0 is required.
New APIs and options 1
mergeSchemas and makeExecutableSchema now accept this callback to choose how conflicting field types are merged; it also applies to field arguments.
Fixes and other changes 1
Resolver-presence checks now look for subscribe on subscription fields; query and mutation fields still require resolve.
@graphql-tools/schema 104 changes
Deprecations 1
The old positional boolean arguments remain supported but are deprecated in favor of the options object.
New APIs and options 1
mergeDeep now accepts an options object with respectPrototype, respectArrays, respectArrayLength, and respectSymbols settings.
Fixes and other changes 2
Resolver map extension types now use ExtensionsObject, allowing symbol-keyed resolver extensions to type-check under GraphQL.js v17+.
Schema extension merging and extraction, and resolver merging, now preserve symbol keys, including non-enumerable own symbol keys.
@graphql-tools/schema 89 changes
Breaking changes 8
addErrorLoggingToSchema was removed; logging and debugging can be implemented outside resolvers using a plugin-system-based library such as Envelop.
addSchemaLevelResolver was removed; resolvers can be wrapped using Resolvers Composition.
The allowUndefinedResolve option in makeExecutableSchema was removed because GraphQL Schema itself performs this checking.
buildSchemaFromTypeDefinitions is no longer exported; use buildSchema from graphql-js instead.
Directive Resolvers were removed; use the new method documented for schema directives.
Legacy Schema Directives were removed; use the new method documented for schema directives.
logger was removed; logging and debugging can be implemented outside resolvers using a plugin-system-based library such as Envelop.
The schema level resolvers feature was removed; resolvers can be wrapped using Resolvers Composition.
Behavior and default changes 1
The merge package is used to handle typeDefs and resolvers merging.