# What changed in @graphql-yoga/plugin-defer-stream

> 11 changes in @graphql-yoga/plugin-defer-stream 3 to 4 from its official release notes, upgrade guides and advisories: 9 breaking. Each one cited. Sources checked 2026-11-13. HTML: https://unstale.sh/npm/@graphql-yoga/plugin-defer-stream/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @graphql-yoga/plugin-defer-stream 4

### Breaking changes

- Plugins added with addPlugin are inserted in place, so their hooks execute immediately after the plugin that added them rather than last. (4.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v4)
- The migration instructions say to install the new NPM package graphql-yoga. (4.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v4)
- Node.js v16 is no longer supported. (4.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v4)

### Behavior and default changes

- Yoga maps the GraphQL HTTP Accept header to the executor's incrementalSpec. v0.2 uses its payload format and is echoed on Content-Type; v0.1 remains the default for deferSpec=20220824 or bare multipart/mixed, and unsupported specs yield 406. (4.0.0) — [release notes](https://github.com/graphql-hive/graphql-yoga/releases/tag/%40graphql-yoga/plugin-defer-stream%404.0.0)

## @graphql-yoga/plugin-defer-stream 3

### Breaking changes

- This graphiql option is removed completely because it was not used. (3.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v3)
- This graphiql option is removed completely because it was not used. (3.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v3)
- Subscriptions now implement GraphQL over SSE “distinct connections mode” instead of Yoga’s previous custom SSE transport. (3.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v3)
- Install the new NPM package for Yoga. (3.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v3)
- Subscriptions no longer support multipart/mixed as a transport method; only text/event-stream is supported. (3.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v3)
- A single option now configures the parse and validation cache, replacing two separate envelop plugins. (3.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v3)

### Fixes and other changes

- The notes recommend using graphql-sse on the client side for subscriptions. (3.0.0) — [upgrade guide](https://the-guild.dev/graphql/yoga-server/docs/migration/migration-from-yoga-v3)