diff --git a/services.xml b/services.xml
index 00db21d..1978fb3 100644
--- a/services.xml
+++ b/services.xml
@@ -1,7 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
   services.xml - simple list of services for the homepage
-  Fields: id, name, proto, port, logo (filename in /logos/), note (optional)
+  Fields:
+    - id: unique identifier (optional)
+    - name: display name (required)
+    - proto: protocol - http or https (optional, default: http)
+    - port: port number (optional, shows info button if present with host)
+    - host: custom hostname or full URL (optional)
+    - logo: filename in /logos/ (optional, default: default.svg)
+    - status: online, offline, or maintenance (optional, shows colored dot indicator)
 -->
 <services>
   <service id="portainer" name="Portainer" proto="https" port="9443" logo="portainer.svg" />