What is a supergraph?

A supergraph is an architecture and operating model to build and scale multiple data domains as a single graph of composable entities and operations. 

Supergraphs help us get the benefits of a centralized monolithic approach (high cohesion and easy governance) on a federated microservices execution model (loose coupling and scaling ownership).
 Today, supergraphs are more critical than ever because accelerating data and microservice sprawl is making the complexity of data and API consumption untenable – showing up in slower time-to-market, harder to address tech-debt, and complex team communication.

This pattern has emerged in organizations like Netflix, Airbnb, Goldman Sachs, and LinkedIn.


A supergraph provides a unified, composable, and federated data access layer

The supergraph architecture provides a technology platform and an operating model to enable unfettered decoupling of product and domain teams, while giving them the means to maintain a high-degree of cohesion as they evolve.

When a supergraph architecture is a must-have
Slow onboarding and brittle integration due to inconsistent API design, versioning, and lack of typed API schemas
Incrementally decomposing a monolithic domain while ensuring a stable API
Providing access to new data domains over a unified API to support an integrated experience
Needing a unified API on federated domains, without introducing a single point of failure and centralization
Battling tedious integration and poor performance because of pervasive N+1 calls that require time-consuming creation of composable or custom API endpoints

Key capabilities of a supergraph

A supergraph creates compounding benefits as more subgraphs come into existence and related domains get connected into a supergraph. 

Unified semantic layer

A unified semantic layer that describes entities, operations, and relationships spanning one or more data domains.

Composable API

Process incoming API requests to the supergraph and distribute them to upstream services and fulfill the request.

Federated SDLC and governance

The ability for multiple teams to collaborate on evolving the supergraph's unified semantic layer and the API schema, with no centralized ownership or single point of operational failure.

Query planning and distributed execution

A standardized API schema to access entities and invoke operations, as well as traverse and compose along relationships – typically GraphQL.

Learn how to easily build and operate a supergraph with the Hasura Data Delivery Network. 

Learn how to easily build and operate a supergraph with the Hasura Data Delivery Network. 
2024 Edition

Supergraph Architecture Guide

The Supergraph Manifesto provides essential strategies, ready-to-use tactics, reference architecture & schema, and an operating model for fostering shared ownership of subgraphs across teams.
Supergraph Architecture Guide