From 91583cecc3a9b63ef8c880cbdfc95df386756983 Mon Sep 17 00:00:00 2001
From: Sushant Poudel <215148952+sushant-me@users.noreply.github.com>
Date: Mon, 7 Sep 2026 01:08:09 +0545
Subject: [PATCH] docs: clarify matrix context property case sensitivity

---
 content/actions/reference/workflows-and-actions/contexts.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/content/actions/reference/workflows-and-actions/contexts.md b/content/actions/reference/workflows-and-actions/contexts.md
index 73f4e13158f9..9f5e64fe0200 100644
--- a/content/actions/reference/workflows-and-actions/contexts.md
+++ b/content/actions/reference/workflows-and-actions/contexts.md
@@ -725,6 +725,9 @@ For workflows with a matrix, the `matrix` context contains the matrix properties
 
 There are no standard properties in the `matrix` context, only those which are defined in the workflow file.
 
+> [!NOTE]
+> **Case sensitivity:** Matrix property names are case-sensitive. If you define `arch` in your matrix, you must reference `matrix.arch` (not `matrix.Arch`) to access its value.
+
 | Property name | Type | Description |
 |---------------|------|-------------|
 | `matrix` | `object` | This context is only available for jobs in a matrix, and changes for each job in a workflow run. You can access this context from any job or step in a workflow. This object contains the properties listed below. |