diff --git a/content/actions/reference/workflows-and-actions/workflow-syntax.md b/content/actions/reference/workflows-and-actions/workflow-syntax.md
index 0953709ba987..159b9a0343df 100644
--- a/content/actions/reference/workflows-and-actions/workflow-syntax.md
+++ b/content/actions/reference/workflows-and-actions/workflow-syntax.md
@@ -175,6 +175,8 @@ on:
 ### Git diff comparisons
 
 {% data reusables.actions.workflows.triggering-a-workflow-paths5 %}
+> [!NOTE]
+> **Changes to files in a git submodule:** For {% data variables.product.prodname_actions %} to detect changes to files inside a git submodule, filter on the path to the top-level submodule itself, not on paths within the submodule. For example, if a submodule is checked out at `submodules/my-library`, use `paths: - submodules/my-library/**`. The paths to individual files inside the submodule are not tracked by the parent repository's workflow filters.
 
 ## `on.schedule`