diff --git a/eww/sh/values/README.md b/eww/sh/values/README.md
new file mode 100644
index 0000000..933d256
--- /dev/null
+++ b/eww/sh/values/README.md
@@ -0,0 +1,4 @@
+# Values
+
+Scripts that give various values: volume, brightness level, ip address, etc.  
+Many print `.json` values when dealing with multiple values obtained from the same command/script. Json is easily handled by Eww.
\ No newline at end of file