Skip to main content

Migration from Merge GraphQL Schemas

Merge GraphQL Schemas was using GraphQL Toolkit's @graphql-toolkit/schema-merging package under the hood but we decided to deprecate it in favor of new GraphQL Tools's @graphql-tools/merge package and you need to update your project.

Merging Type Definitions#

Instead of mergeTypes, you need to use mergeTypeDefs from @graphql-tools/merge package. The API is almost same except schemaDefinition option.

We were using the following implementation to proxy mergeTypes to mergeTypeDefs of GraphQL Toolkit.

import { mergeTypeDefs } from '@graphql-toolkit/schema-merging';
type Config = Parameters<typeof mergeTypeDefs>[1];
export const mergeTypes = (types: any[], options?: { schemaDefinition?: boolean, all?: boolean } & Partial<Config>) => {
const schemaDefinition = options && typeof options.schemaDefinition === 'boolean'
? options.schemaDefinition
: true;
return mergeTypeDefs(types, {
useSchemaDefinition: schemaDefinition,
forceSchemaDefinition: schemaDefinition,
throwOnConflict: true,
commentDescriptions: true,
reverseDirectives: true,

So if you want to have exact behavior, you can use the options above. Other than that, the API and behavior are almost same.

import { mergeTypes, mergeResolvers, fileLoader } from 'merge-graphql-schemas';

should become

import { mergeTypeDefs, mergeResolvers } from '@graphql-tools/merge';
import { loadFilesSync } from '@graphql-tools/load-files';

So you can replace mergeTypes with mergeTypeDefs and fileLoader with loadFilesSync.