From 281c7d567ee94b5c9f13f29ca0d8a2459212ea08 Mon Sep 17 00:00:00 2001
From: Aidan Timson <aidan@timmo.dev>
Date: Wed, 12 Nov 2025 17:03:14 +0000
Subject: [PATCH] Add docs for dashboard time visibility condition (#41605)

---
 source/_dashboards/conditional.markdown | 37 +++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/source/_dashboards/conditional.markdown b/source/_dashboards/conditional.markdown
index b808f271eaa..a734903a8b9 100644
--- a/source/_dashboards/conditional.markdown
+++ b/source/_dashboards/conditional.markdown
@@ -220,6 +220,43 @@ locations:
   type: list
 {% endconfiguration %}
 
+### Time
+
+Specify the visibility of the card based on the current time and day of the week.
+
+```yaml
+condition: time
+after: "08:00"
+before: "17:00"
+weekdays:
+  - mon
+  - tue
+  - wed
+  - thu
+  - fri
+```
+
+{% configuration %}
+condition:
+  required: true
+  description: "`time`"
+  type: string
+after:
+  required: false
+  description: Time in 24-hour format (HH:MM) after which the card should be visible.*
+  type: string
+before:
+  required: false
+  description: Time in 24-hour format (HH:MM) before which the card should be visible.*
+  type: string
+weekdays:
+  required: false
+  description: List of weekdays on which the card should be visible. Valid values are `mon`, `tue`, `wed`, `thu`, `fri`, `sat`, `sun`.
+  type: list
+{% endconfiguration %}
+
+At least one of `after` or `before` must be used for this condition to be valid. Both can be used together to define a time range as in the example above.
+
 ### And
 
 Specify that all conditions must be met.