From 266bab62ea1350164d6428d9c08443ad49d5cfb2 Mon Sep 17 00:00:00 2001
From: Matt C <41025489+mcummings128@users.noreply.github.com>
Date: Tue, 5 May 2026 21:32:27 -0400
Subject: [PATCH] Update control jobs with conditions documentation

Clarify usage of conditions in job execution and note limitations for shell conditions.
---
 .../choose-when-workflows-run/control-jobs-with-conditions.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md b/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md
index cf474fc9cd40..e05c2ee4e388 100644
--- a/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md
+++ b/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md
@@ -15,7 +15,9 @@ category:
 contentType: how-tos
 ---
 
-You can use the `jobs.<job_id>.if` conditional to prevent a job from running unless a condition is met. {% data reusables.actions.if-supported-contexts %}
+You can use the `jobs.<job_id>.if` conditional to prevent a job from running unless a condition is met. {% data reusables.actions.if-supported-contexts %} 
+
+Note that conditions executed by a shell (for example `[[ $variable == "prefix"* ]]`) can not be evaluated in `jobs.<job_id>.if`. Such conditions must be written inside `jobs.<job_id>.steps[*].run`.
 
 ### Example: Only run job for a specific repository