diff --git a/docs/source/upgrade-guide/index.md b/docs/source/upgrade-guide/index.md
index 620c5ea125..3e39500468 100644
--- a/docs/source/upgrade-guide/index.md
+++ b/docs/source/upgrade-guide/index.md
@@ -170,6 +170,22 @@ In your add-ons and projects, we advise you to always use the public components
 
 This change improves UX of the Babel view (translation form) since a disabled field cannot be selected to be copied over.
 
+### `volto-slate` Cypress helpers moved to its own module
+
+There were some Cypress helpers for `volto-slate` along with the other definition of Cypress commands.
+The Cypress command definitions are intended to be only loaded once, and the helpers can be imported a number of times.
+Therefore, we moved the helpers to its own module:
+
+```
+import { slateBeforeEach } from '@plone/volto/cypress/support/commands';
+```
+
+becomes:
+
+```
+import { slateBeforeEach } from '@plone/volto/cypress/support/helpers';
+```
+
 (volto-upgrade-guide-17.x.x)=
 
 ## Upgrading to Volto 17.x.x