Apollo GraphQL Documentation Index (llms.txt)
You are viewing a deploy preview. Click to return to the live site.
Docs
Resources Resources
Search Apollo content (Cmd+K or /)
Sign In

Apollo Federation

Overview
Federated Schemas
OverviewSchema TypesSchema CompositionSharing Types (Value Types)

Federation Reference

Federation ChangelogFederation DirectivesComposition Rules

Subgraph Reference

Federation Subgraphs SpecificationSubgraph Specific FieldsCompatible Subgraph Libraries

Development and Tooling

Query PlansComposition HintsErrors

From Federation 1 to 2

Upgrade GuideFederation 2 Backwards Compatibility
Entities
Introduction

Entity Essentials

Entity FieldsAdvanced KeysEntity Interfaces

Entity Guides

Entity Best PracticesMigrate FieldsResolve Another Subgraph's FieldsEnforce OwnershipUse Contexts
Schema Design Guides

Schema Design Principles

Demand Oriented Schema DesignNaming ConventionsNamespacing

Server-Driven UI

BasicsSchema DesignClient Design

Data Handling Techniques

Handling the N+1 ProblemNullabilityInterfacesResponse Type PatternErrors as DataAggregating DataGraph Identities

Schema Development and Evolution

Mocking to Unblock DevelopmentDeprecationsDistributed OrchestrationMigrating from a MonolithMigrating from Schema Stitching
Navigation controls
Apollo Federation
Overview
Federated Schemas
OverviewSchema TypesSchema CompositionSharing Types (Value Types)

Federation Reference

Federation ChangelogFederation DirectivesComposition Rules

Subgraph Reference

Federation Subgraphs SpecificationSubgraph Specific FieldsCompatible Subgraph Libraries

Development and Tooling

Query PlansComposition HintsErrors

From Federation 1 to 2

Upgrade GuideFederation 2 Backwards Compatibility
Entities
Introduction

Entity Essentials

Entity FieldsAdvanced KeysEntity Interfaces

Entity Guides

Entity Best PracticesMigrate FieldsResolve Another Subgraph's FieldsEnforce OwnershipUse Contexts
Schema Design Guides

Schema Design Principles

Demand Oriented Schema DesignNaming ConventionsNamespacing

Server-Driven UI

BasicsSchema DesignClient Design

Data Handling Techniques

Handling the N+1 ProblemNullabilityInterfacesResponse Type PatternErrors as DataAggregating DataGraph Identities

Schema Development and Evolution

Mocking to Unblock DevelopmentDeprecationsDistributed OrchestrationMigrating from a MonolithMigrating from Schema Stitching
Products
Apollo GraphOS PlatformManage, observe, and scale your graph.Apollo ConnectorsConnect REST APIs to your graph declaratively.Apollo FederationFederate multiple subgraphs into a single supergraph.Rover CLIInteract with your graph from the command line.Apollo RouterRun and configure your graph gateway.Apollo OperatorDeploy and manage Apollo Router on Kubernetes.
Open source
Apollo Client (Web)Simplify GraphQL data management in web apps.Apollo iOSSwift-first GraphQL client for iOS.Apollo KotlinKotlin-first GraphQL client for Android and JVM.Apollo ServerBuild GraphQL servers with Node.js.Apollo MCP ServerExpose GraphQL tools to AI agents with MCP.IDE SupportEnhance your development workflow with IDE support.
Resources
Home
/ Apollo Federation

Schema Design

Design a unified data layer with Apollo Federation

Schemas define the structure, types, and relationships to orchestrate your data and connected data sources, enabling precise querying and consistent communication between clients and servers.

Intro to Apollo Federation

Learn the benefits of combining your APIs into a unified GraphQL API with Apollo Federation as your API orchestration layer.

Intro to Entities

Learn to define and use the fundamental shared object type of Apollo Federation.

Schema Design Guides

Naming Conventions

Conventions and considerations for types, fields, and arguments.

Namespacing

Organize root-level operation fields into namespaces.

Schema Design Tools

Schema Proposals

GraphOS Schema proposals offer centralized schema change management, fostering collaboration and strengthening governance.

IDE Support

Apollo provides plugins and extensions for IDEs like VS Code and JetBrains to enable syntax highlighting, intelligent autocomplete, inline performance info and more.

© 2026 Apollo Graph Inc., d/b/a Apollo GraphQL.

Privacy Policy

Company

  • About Apollo
  • Careers
  • Partners

Resources

  • Blog
  • Tutorials
  • Content Library
  • UX Writing Style

Get in touch

  • Contact Sales
  • Contact Support