diff --git a/etc/defaults.conf b/etc/defaults.conf
index e3876cdc7d2..d69b4a45408 100644
--- a/etc/defaults.conf
+++ b/etc/defaults.conf
@@ -158,3 +158,9 @@ XBPS_SUCMD="sudo /bin/sh -c"
 # When unset, newly build package overwrites the older one.
 #
 #XBPS_PRESERVE_PKGS=yes
+
+# [OPTIONAL]
+# Show more detailed output in ./xbps-src update-check. Useful for debugging.
+# This can also be set or exported as a regular environment variable.
+#
+#XBPS_UPDATE_CHECK_VERBOSE=yes