diff --git a/docs/docs/how-tos/index.md b/docs/docs/how-tos/index.md
index 91ce370a..f0c3814d 100644
--- a/docs/docs/how-tos/index.md
+++ b/docs/docs/how-tos/index.md
@@ -76,6 +76,7 @@ These guides show how to use different streaming modes.
 - [How to force an agent to call a tool](force-calling-a-tool-first.ipynb)
 - [How to handle tool calling errors](tool-calling-errors.ipynb)
 - [How to pass runtime values to tools](pass-run-time-values-to-tools.ipynb)
+- [How to update graph state from tools](update-state-from-tools.ipynb)
 
 ### Subgraphs
 
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index f01a7a8e..196080eb 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -141,6 +141,7 @@ nav:
               - how-tos/force-calling-a-tool-first.ipynb
               - how-tos/tool-calling-errors.ipynb
               - how-tos/pass-run-time-values-to-tools.ipynb
+              - how-tos/update-state-from-tools.ipynb
           - Subgraphs:
               - Subgraphs: how-tos#subgraphs
               - how-tos/subgraph.ipynb