Federation Version Support

Check router version compatibility with Apollo Federation versions

The GraphOS Router and Apollo Router Core support supergraph schemas that are generated via Apollo Federation 2.x composition. This composition algorithm is usually performed by one of the following:

  • Apollo GraphOS (for supergraphs that use managed federation)

  • The Rover CLI (for non-managed supergraphs)

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

tip
Update your router regularly to the latest stable version to ensure that it fully supports its supergraph schema.

Support table

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

caution
Avoid router versions marked with ⚠️. These versions include bugs described in the changelog.
Router version Federation version
v1.57.0 and later (see latest releases)2.9.3
v1.56.02.9.2
v1.55.02.9.1
v1.52.1 - v1.53.02.9.0
v1.52.12.8.5
v1.49.0 - v1.52.02.8.1
v1.48.0 - v1.49.02.8.0
v1.46.0 - v1.47.02.7.5
v1.45.12.7.2
⚠️ v1.45.02.7.2
v1.39.0 - v1.44.02.7.1
v1.38.02.6.3
v1.36.0 - v1.37.02.6.2
v1.35.02.6.1
v1.34.12.5.7
v1.33.0 - v1.34.02.5.5
v1.30.0 - v1.32.02.5.4
️v1.29.12.5.3
⚠️ v1.29.02.5.3
⚠️ v1.28.0 - v1.28.12.5.1
v1.25.0 - v1.27.02.4.10
v1.24.02.4.9
v1.21.0 - v1.23.02.4.8
v1.20.02.4.7
️⚠️ v1.19.12.4.6
⚠️ v1.19.02.4.5
v1.16.0 - v1.18.12.4.2
v1.15.0 - v1.15.12.4.1
v1.13.1 - v1.14.02.4.0
v1.11.0 - v1.13.02.3.2
v1.10.2 - v1.10.32.3.1
⚠️ v1.10.12.3.1
⚠️ v1.10.02.3.0
v1.6.0 - v1.9.02.2.2
v1.2.1 - v1.5.02.1.4
v1.0.0 - v1.2.02.1.3
See pre-1.0 versions
Router version Federation version
v1.0.0-rc.1 and v1.0.02.1.2-alpha.2
v1.0.0-rc.02.1.2-alpha.1
v1.0.0-alpha.32.1.2-alpha.0
v1.0.0-alpha.1 - v1.0.0-alpha.22.1.1
v0.16.0 - v1.0.0-alpha.02.1.0-alpha.4
v0.9.0 – v0.15.12.0.2
v0.1.0-preview.5 – v0.1.0-preview.72.0.1
v0.1.0-preview.42.0.0
v0.1.0-preview.32.0.0-preview.7

Federation 1 support

Only Apollo Router Core and GraphOS Router v1.59 and earlier support Federation v1.x supergraphs. The following don't support Federation v1.x:

  • Router v1.60 and later

  • Router v2.0 and later

Learn how to upgrade from Federation version 1 to 2.
Feedback

Edit on GitHub

Forums