diff --git a/docs/source/upgrade-guide/index.md b/docs/source/upgrade-guide/index.md
index d8085abdbe..a9b9648ece 100644
--- a/docs/source/upgrade-guide/index.md
+++ b/docs/source/upgrade-guide/index.md
@@ -196,6 +196,14 @@ Replace the `.storybook` folder in your project with this one:
 
 https://github.com/plone/volto/tree/5605131868689778bbdca0c3003a40cb9f153c1a/packages/generator-volto/generators/app/templates/.storybook
 
+Then update your project's or add-on `scripts` key like:
+
+```diff
+-    "storybook": "start-storybook -p 6006",
+-    "build-storybook": "build-storybook"
++    "storybook": "storybook dev -p 6006",
++    "build-storybook": "storybook build"
+```
 
 ```{seealso}
 [Migration guide from Storybook 6.x to 8.0](https://storybook.js.org/docs/migration-guide/from-older-version)