diff --git a/bucket/1password-cli.json b/bucket/1password-cli.json
index 79dbe269d9..fc5ea89edc 100644
--- a/bucket/1password-cli.json
+++ b/bucket/1password-cli.json
@@ -17,6 +17,11 @@
         }
     },
     "bin": "op.exe",
+    "notes": [
+        "1Password CLI v2 completely changes the commands schema! Either migrate your setup, following ",
+        "instructions on https://developer.1password.com/docs/cli/upgrade/#step-2-update-your-scripts ",
+        "or install 1Password CLI v1 from the Versions bucket."
+    ],
     "checkver": {
         "url": "https://app-updates.agilebits.com/product_history/CLI2",
         "regex": "/op_windows_amd64_v([\\d.]+)\\.zip"