diff --git a/.changeset/honor-archive-data-dir.md b/.changeset/honor-archive-data-dir.md
index 705e87b..df07440 100644
--- a/.changeset/honor-archive-data-dir.md
+++ b/.changeset/honor-archive-data-dir.md
@@ -3,3 +3,5 @@
 ---
 
 Store session archive metadata and archived session files under `PI_WEB_DATA_DIR` when configured.
+
+Previously, session archives always used `~/.pi-web`, even when `PI_WEB_DATA_DIR` selected another managed-state root. Existing archives created with a custom `PI_WEB_DATA_DIR` remain in `~/.pi-web` and are not migrated automatically. Before upgrading, stop the session daemon and back up both locations before reconciling them manually. Because the archive index stores absolute `archivePath` values, update those values when moving archived files.
diff --git a/docs/config.md b/docs/config.md
index b06bb9b..37e4840 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -131,7 +131,7 @@ Rows with JSON key `—` are runtime-only environment variables, not config-file
 
 The session daemon owns both archive locations. Restart the session daemon after setting or changing `PI_WEB_DATA_DIR`; restart the web/API process as well so its other managed-state stores use the same root.
 
-PI WEB does not automatically migrate existing managed state. Archives created by earlier releases while a custom `PI_WEB_DATA_DIR` was already set may remain under `~/.pi-web` and will not appear automatically after upgrading. Stop the session daemon and back up both locations before reconciling them manually. The archive index stores absolute `archivePath` values, so update those values if archived files are moved to a different path.
+PI WEB does not move existing managed state when `PI_WEB_DATA_DIR` changes. Stop the session daemon and back up the source and destination before moving archive data manually. The archive index stores absolute `archivePath` values, so update those values when archived files move to a different path.
 
 ### External path access