diff --git a/docs/syntax/substitutions.md b/docs/syntax/substitutions.md
index d3513932c..e6d5b9572 100644
--- a/docs/syntax/substitutions.md
+++ b/docs/syntax/substitutions.md
@@ -24,6 +24,8 @@ subs:
 If a substitution is defined globally it may not be redefined (shaded) in a files `frontmatter`. 
 Doing so will result in a build error.
 
+To use the variables in your files, surround them in curly brackets (`{{variable}}`).
+
 ## Example
 
 Here are some variable substitutions: