diff --git a/website/docs/reference/cli-commands.md b/website/docs/reference/cli-commands.md
index ab1ecf526..164cf70b3 100644
--- a/website/docs/reference/cli-commands.md
+++ b/website/docs/reference/cli-commands.md
@@ -443,12 +443,22 @@ hermes backup --quick --label "pre-upgrade"  # Quick snapshot with label
 hermes import <zipfile> [options]
 ```
 
-Restore a previously created Hermes backup into your Hermes home directory.
+Restore a previously created Hermes backup into your Hermes home directory. Files are overlaid onto your current Hermes home — existing files are skipped unless `--force` is used.
 
 | Option | Description |
 |--------|-------------|
 | `-f`, `--force` | Overwrite existing files without confirmation. |
 
+:::warning
+Stop the gateway before importing to avoid conflicts with running processes.
+:::
+
+### Examples
+```bash
+hermes import ~/hermes-backup-20260423.zip           # Restore, skip existing files
+hermes import ~/hermes-backup-20260423.zip --force   # Restore, overwrite existing files
+```
+
 ## `hermes logs`
 
 ```bash