diff --git a/userguide/content/en/docs/adding-content/shortcodes/index.md b/userguide/content/en/docs/adding-content/shortcodes/index.md
index cc416664d6..d41e463814 100644
--- a/userguide/content/en/docs/adding-content/shortcodes/index.md
+++ b/userguide/content/en/docs/adding-content/shortcodes/index.md
@@ -442,6 +442,16 @@ says "Couldn’t find the X-Frame-Options header in the response headers." you
 found in the HTTP response headers as highlighted below.", you **CANNOT** -
 unless it has been explicitly enabled for your site. {{% /alert %}}
 
+### comment
+
+Use the `comment` shortcode to add internal notes or comment out large blocks of Markdown or HTML that won't be rendered on the page.
+
+```go-template
+{{< comment >}}
+This comment will not be visible in the rendered page.
+{{< /comment >}}
+```
+
 ## Tabbed panes
 
 Sometimes it's very useful to have tabbed panes when authoring content. One