Docs
Try Apollo Studio

Federation version support in the Apollo Router


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

  • Apollo Studio (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. 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 router release is compiled against. You might encounter issues if your router uses an earlier version of federation than the version that was used to compose its supergraph schema.

Router versionFederation version
v1.2.1 and later (see latest releases)2.1.4
v1.0.0 - v1.2.02.1.3
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

Federation 2.x composition is backward compatible with Federation 1.x subgraph schemas, so you can use the Apollo Router with any valid Federation 1.x supergraph.

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

Edit on GitHub
Previous
Moving from @apollo/gateway
Next
Overview