diff --git a/docs/configs/services.md b/docs/configs/services.md
index 6e1b15761..08a053570 100644
--- a/docs/configs/services.md
+++ b/docs/configs/services.md
@@ -139,7 +139,7 @@ Each widget can optionally provide a list of which fields should be visible via
 
 ### Block Highlighting
 
-Widgets can tint their metric block text automatically based on rules defined alongside the service. Attach a `highlight` section to the widget configuration and map each block to one or more numeric or string rules using the field key (for example, `queued`, `lan_users`).
+Widgets can tint their metric block text automatically based on rules defined alongside the service. Attach a `highlight` section to the widget configuration and map each block to one or more numeric or string rules using the field key (for example, `queued`, `lan_users`). The custom api widget does not support highlighting.
 
 ```yaml
 - Sonarr:
diff --git a/docs/widgets/services/customapi.md b/docs/widgets/services/customapi.md
index 37a48fd8c..c820a21bb 100644
--- a/docs/widgets/services/customapi.md
+++ b/docs/widgets/services/customapi.md
@@ -146,6 +146,10 @@ The widget supports different display modes that can be set using the `display`
 
 The default display mode is `block`, which shows fields in a block format.
 
+!!! note
+
+    The Custom API widget does not currently support [block highlighting](../../configs/services.md#block-highlighting) in any display mode.
+
 ### List View
 
 You can change the default block view to a list view by setting the `display` option to `list`.