From c393e8a48af03dc2eea4e7479cdc8e26d00ac0cd Mon Sep 17 00:00:00 2001
From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Thu, 16 Jul 2026 15:08:53 -0700
Subject: [PATCH] Documentation: note customapi block highlighting limitation

---
 docs/configs/services.md           | 2 +-
 docs/widgets/services/customapi.md | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

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`.