diff --git a/plugins/asdf/README.md b/plugins/asdf/README.md
index e8ff2d740..1e805c402 100644
--- a/plugins/asdf/README.md
+++ b/plugins/asdf/README.md
@@ -34,6 +34,11 @@ asdf set nodejs latest
 asdf set -u nodejs 16.5.0
 ```
 
+## Backward Compatibility
+
+`asdf` has significantly changed since 0.16.0. The current implementation doesn't along with older versions. **If you're using 0.15.0 or older version, please follow upgrade guide in official page**: https://asdf-vm.com/guide/upgrading-to-v0-16.html.
+
+
 ## Maintainer
 
 - [@RobLoach](https://github.com/RobLoach)
diff --git a/plugins/asdf/asdf.plugin.zsh b/plugins/asdf/asdf.plugin.zsh
index 318267dcb..438152ed8 100644
--- a/plugins/asdf/asdf.plugin.zsh
+++ b/plugins/asdf/asdf.plugin.zsh
@@ -1,5 +1,10 @@
 (( ! $+commands[asdf] )) && return
 
+# TODO(roeniss): 2025-03-31 - remove this warning and related README section after enough grace period.
+if [[ -d "$HOME/.asdf" ]]; then
+  echo "[omz] You have enabled asdf plugin, but your asdf version seems too low. Please upgrade to at least 0.16.0 to use completion. See omz asdf plugin README for more details."
+fi
+
 export ASDF_DATA_DIR="${ASDF_DATA_DIR:-$HOME/.asdf}"
 path=("$ASDF_DATA_DIR/shims" $path)