diff --git a/content/templates/shortcode-templates.md b/content/templates/shortcode-templates.md
index 6723d580a..d18514eb3 100644
--- a/content/templates/shortcode-templates.md
+++ b/content/templates/shortcode-templates.md
@@ -100,10 +100,10 @@ The `.Params` variable in shortcodes contains the list parameters passed to shor
 : these are the parameters passed directly into the shortcode declaration (e.g., a YouTube video ID)
 
 `$.Page.Params`
-: refers to the page's params; the "page" in this case refers to the content file in which the shortcode is declared (e.g., a `shortcode_color` field in a content's front matter).
+: refers to the page's params; the "page" in this case refers to the content file in which the shortcode is declared (e.g., a `shortcode_color` field in a content's front matter could be accessed via `$.Page.Params.shortcode_color`).
 
 `$.Page.Site.Params`
-: refers to global variables as defined in your [site's configuration file][config]
+: refers to global variables as defined in your [site's configuration file][config].
 
 #### `.IsNameParams`