diff --git a/py3status/modules/whatismyip.py b/py3status/modules/whatismyip.py
index 98ee242d6a..9c163580cb 100644
--- a/py3status/modules/whatismyip.py
+++ b/py3status/modules/whatismyip.py
@@ -35,6 +35,17 @@
     color_degraded: Output is unexpected (IP/country mismatch, etc.)
     color_good: Online
 
+Examples:
+```
+# ip options
+whatismyip {
+    url_geo = "https://ifconfig.co/json"
+    url_geo = "https://api.ip2location.io"
+    url_geo = "https://ipinfo.io/json"
+    url_geo = "http://ip-api.com/json"
+}
+```
+
 @author ultrabug, Cyril Levis (@cyrinux)
 
 SAMPLE OUTPUT