diff --git a/docs/infrastructure_and_maintenance/performance.md b/docs/infrastructure_and_maintenance/performance.md
index 67f1d61795..778674a698 100644
--- a/docs/infrastructure_and_maintenance/performance.md
+++ b/docs/infrastructure_and_maintenance/performance.md
@@ -52,6 +52,17 @@ In production setups:
 - Always enable opcache for php-fpm/`mod_php`.
 - Prefer php-fpm and web server using it over fast-cgi for lower overall memory usage.
 
+!!! caution
+
+    To avoid deprecations when using PHP 8.2 or 8.3, [[= product_name =]] v4.6 needs an additional error handler.
+    The error handler is present by default for projects that started with 4.6.8 or later.
+    For projects that started with earlier versions, you need to add the error handler manually by running the following commands:
+
+    ``` bash
+    composer config extra.runtime.error_handler "\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
+    composer dump-autoload
+    ```
+
 ### Symfony
 
 - Review the [Symfony performance documentation]([[= symfony_doc =]]/performance.html) and apply matching suggestions, including OPCache configuration if enabled.
diff --git a/docs/update_and_migration/from_4.6/update_from_4.6.md b/docs/update_and_migration/from_4.6/update_from_4.6.md
index c8d1cfbcab..fa93e89ada 100644
--- a/docs/update_and_migration/from_4.6/update_from_4.6.md
+++ b/docs/update_and_migration/from_4.6/update_from_4.6.md
@@ -32,6 +32,15 @@ First, run:
 
 Then execute the instructions below starting from the version you're upgrading from.
 
+!!! caution
+
+    To avoid deprecations when using PHP 8.2 or 8.3, run the following commands:
+
+    ``` bash
+    composer config extra.runtime.error_handler "\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
+    composer dump-autoload
+    ```
+
 <!-- vale Ibexa.VariablesVersion = NO -->
 
 ## v4.6.1
@@ -123,12 +132,7 @@ No additional steps needed.
 
 ## v4.6.8
 
-To avoid deprecations when updating from an older PHP version to PHP 8.2 or 8.3, run the following commands:
-
-``` bash
-composer config extra.runtime.error_handler "\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
-composer dump-autoload
-```
+No additional steps needed.
 
 ## v4.6.9