diff --git a/docs/dev_101_services.md b/docs/dev_101_services.md
index 1cae85a9..25e7458b 100644
--- a/docs/dev_101_services.md
+++ b/docs/dev_101_services.md
@@ -118,6 +118,19 @@ set_speed:
             - "low"
             - "medium"
             - "high"
+    # Fields can be grouped in collapsible sections, this is useful to initially hide
+    # advanced fields. Note that the collapsible section only affect presentation to the
+    # user, service data will not be nested.
+    advanced_fields:
+      # Whether or not the section is initially collapsed (default = false)
+      collapsed: true
+      # Input fields in this section
+      fields:
+        speed_pct:
+          selector:
+            number:
+              min: 0
+              max: 100
 ```
 
 :::info