Join us for GraphQL Summit, October 10-12 in San Diego. Use promo code ODYSSEY for $400 off your pass.
Launch GraphOS Studio

Federation version support in the Apollo Router

The Apollo supports s that are generated via Apollo Federation 2.x composition. This composition algorithm is usually performed by one of the following:

  • Apollo (for s that use managed federation)
  • The CLI (for non-managed s)

Apollo Federation is an evolving project, and its composition algorithm regularly receives new features and bug fixes.

To help ensure that your router fully supports its supergraph schema, you should regularly update it to the latest stable version.

Support table

The table below shows which version of federation each release is compiled against. Make sure that your router's federation version is at least as recent as the version used to compose your .

Avoid router versions marked with ⚠️. These versions include bugs described in the changelog.

Router versionFederation version
v1.30.0 and later (see latest releases)2.5.4
⚠️ v1.
⚠️ v1.28.0 - v1.
v1.25.0 - v1.
v1.21.0 - v1.
️⚠️ v1.
⚠️ v1.
v1.16.0 - v1.
v1.15.0 - v1.
v1.13.1 - v1.
v1.11.0 - v1.
v1.10.2 - v1.
⚠️ v1.
⚠️ v1.
v1.6.0 - v1.
v1.2.1 - v1.
v1.0.0 - v1.

Federation 1 support

Federation 2.x composition is backward compatible with Federation 1.x s, so you can use the Apollo with any valid Federation 1.x .

If your Federation 1.x doesn't work with the Apollo , see possible causes in Backward compatibility in Federation 2.

Moving from @apollo/gateway
Enterprise features
Edit on GitHubEditForumsDiscord