diff --git a/content/en/templates/shortcode-templates.md b/content/en/templates/shortcode-templates.md
index 839032800..d1a7ceb84 100644
--- a/content/en/templates/shortcode-templates.md
+++ b/content/en/templates/shortcode-templates.md
@@ -110,6 +110,11 @@ by using the self-closing syntax:
 {{</* innershortcode /*/>}}
 ```
 
+{{% warning %}}
+Any shortcode that refers to `.Inner` must be closed or self-closed.
+
+{{% /warning %}}
+
 #### `.Params`
 
 The `.Params` variable in shortcodes contains the list parameters passed to shortcode for more complicated use cases. You can also access higher-scoped parameters with the following logic: