diff --git a/packages/documentation/content/product-updates/2026-05-26-schema-version-promotions-and-rollbacks/index.mdx b/packages/documentation/content/product-updates/2026-05-26-schema-version-promotions-and-rollbacks/index.mdx new file mode 100644 index 00000000..a295dbf3 --- /dev/null +++ b/packages/documentation/content/product-updates/2026-05-26-schema-version-promotions-and-rollbacks/index.mdx @@ -0,0 +1,52 @@ +--- +title: Schema Promotions and Rollbacks +description: + Hive Console now supports schema version promotions and rollbacks through a new CLI command, enabling safer + multi-environment workflows, fast production rollbacks, and improved visibility into subgraph-level changes. +date: 2026-05-26 +authors: [laurin] +--- + +Hive Console now supports schema version promotions and rollbacks through a new CLI command, making it easier to manage multi-environment workflows and recover from problematic deployments. + +## Supergraph Promotions + +You can now promote a composed schema version from one target environment to another without republishing subgraphs. + +This enables more flexible workflows across staging, preview, and production environments while ensuring schema consistency between targets. + +```bash +hive schema:promote \ + --from the-guild/hive/staging \ + --to the-guild/hive/production +``` + +When promoting a schema version, Hive Console creates a new schema version in the destination target using the exact same composed supergraph from the source target. The Hive CDN state is then updated to reflect the promotion automatically. + +## Supergraph Rollbacks + +The same promotion mechanism can also be used within a single target to roll back to a previous schema version. + +This allows platform teams to quickly recover from issues introduced by newly published subgraphs without needing to remove or republish schemas. + +```bash +hive schema:promote \ + --version 9e93a510-6ae7-4361-92d2-bd2370c3b8a8 \ + --to the-guild/hive/production +``` + +The schema version ID can be retrieved from the Console dashboard. + +## Improved Subgraph Changelogs + +Promotions and rollbacks often involve multiple subgraph changes at once. To make these transitions easier to understand, we introduced an improved schema version view with detailed subgraph-level changelogs. + +You can now quickly inspect how individual subgraphs changed between schema versions during promotions and rollbacks. + +## Conclusion + +Schema promotions and rollbacks have been one of the most requested Hive features, and we’re excited to finally ship them. + +These new workflows give platform teams more confidence when deploying changes, managing environments, and responding to production incidents. + +We’d love to hear your feedback.