diff --git a/docs/get-started/algokit.md b/docs/get-started/algokit.md
index 2b22f130..5d19de72 100644
--- a/docs/get-started/algokit.md
+++ b/docs/get-started/algokit.md
@@ -46,6 +46,7 @@ The Algorand AlgoKit CLI is the one-stop shop tool for developers building on th
             ```
         - Restart the terminal to ensure pipx is available on the path
         - Install AlgoKit via pipx: `pipx install algokit`
+        - If you used AlgoKit before, update it with pipx: `pipx upgrade algokit`
         - Restart the terminal to ensure AlgoKit is available on the path
     
     <iframe width="100%" style="aspect-ratio:16/9" src="https://www.youtube-nocookie.com/embed/22RvINnZsRo" title="Installing AlgoKit on Windows" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
@@ -88,6 +89,8 @@ The Algorand AlgoKit CLI is the one-stop shop tool for developers building on th
     pipx install algokit
     ```
 
+    If you used AlgoKit before, update it with pipx: `pipx upgrade algokit`
+
     After the installation completes, **restart the terminal**.
 
 Additional AlgoKit videos are available on the [@AlgoDevs YouTube channel](https://youtube.com/@AlgoDevs).