diff --git a/docs/upgrading/graphcommerce-5-to-6.md b/docs/upgrading/graphcommerce-5-to-6.md
index 78ec43f9c4..4f6ef382dd 100644
--- a/docs/upgrading/graphcommerce-5-to-6.md
+++ b/docs/upgrading/graphcommerce-5-to-6.md
@@ -22,7 +22,7 @@ The route for the product has changed from `/product/[url]`,
 singlular product page for all product types.
 
 ~~You can keep using the old behavior by setting `legacyProductRoute` to true.~~
-The legacy routing has been removed in GraphCommerce 7.
+The legacy routing has been removed in GraphCommerce 8.
 
 You can also change the product route from `/p/[url]` to something else by
 configuring [productRoute](../framework/config.md#productroute-string)
diff --git a/docs/upgrading/graphcommerce-7-to-8.md b/docs/upgrading/graphcommerce-7-to-8.md
new file mode 100644
index 0000000000..6ad9ce53e5
--- /dev/null
+++ b/docs/upgrading/graphcommerce-7-to-8.md
@@ -0,0 +1,18 @@
+# Upgrading from GraphCommerce 6 to 7
+
+Depending on the amounts of customisations you've made, there are some manual
+steps. Please follow the regular [upgrade steps first](./readme.md).
+
+1. [`legacyProductRoute` is removed](#legacyproductroute-is-removed)
+2. [Upgrading your Hygraph schema](#upgrading-your-hygraph-schema)
+
+## `legacyProductRoute` is removed
+
+🟠 Only required if you've used the legacyProductRoute
+
+Remove all `/pages/product/*` routes.
+
+## Upgrading your Hygraph schema
+
+Upgrade your Hygraph schema with the [Hygraph migration cli](../hygraph/cli.md).
+Select `graphcommerce7to8` as version.