From e00c9fbf3768dcb956c9bd5c5fe02b4d89c11a84 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?David=20Ba=C3=B1=C3=B3n?= <david.banon@tecnativa.com>
Date: Fri, 10 Jul 2026 19:30:47 +0200
Subject: [PATCH] [UPD] Add docs related to ENV merge variables

---
 docsource/040_run_migration.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docsource/040_run_migration.rst b/docsource/040_run_migration.rst
index 11a196009af4..ffd7f3c5178f 100644
--- a/docsource/040_run_migration.rst
+++ b/docsource/040_run_migration.rst
@@ -69,6 +69,15 @@ Configuration options
     export OPENUPGRADE_TARGET_VERSION=13.0
 
   (when migrating up to 13.0)
+* When you need to merge or rename private modules, the following environment
+  variables can be used to perform those renames/merges. OpenUpgrade will load the
+  content as a JSON dict, and perform the required operations alongside the OCA ones.
+
+    export OPENUPGRADE_RENAMED_MODULES='{"module_a":"module_b"}'
+    export OPENUPGRADE_MERGED_MODULES='{"old_module":"base", "custom_sale":"sale"}'
+
+  (With these variables, openupgrade will rename "module_a" to "module_b",
+    merge "old_module" into "base" and merge "custom_sale" into "sale")
 
 Obsolete options in the Odoo configuration file
 ...............................................