diff --git a/README.md b/README.md
index 57bfa7db..2b103b0b 100644
--- a/README.md
+++ b/README.md
@@ -72,3 +72,7 @@ See the [docs](https://github.com/micro/micro/tree/master/docs/v2) for detailed
 
 Go Micro is Apache 2.0 licensed.
 
+## Upgrade
+
+[Micro](https://github.com/micro/micro) v3 consolidates Go Micro into it as a single unified platform. 
+Please see the [upgrade guide](https://micro.mu/v2-to-v3-upgrade-guide).