diff --git a/site/content/docs/02-template-syntax.md b/site/content/docs/02-template-syntax.md
index ae07c90993..600634ab11 100644
--- a/site/content/docs/02-template-syntax.md
+++ b/site/content/docs/02-template-syntax.md
@@ -94,6 +94,14 @@ An element or component can have multiple spread attributes, interspersed with r
 <Widget {...things}/>
 ```
 
+---
+
+*`$$props`* references all props that are passed to a component – including ones that are not declared with `export`. It is useful in rare cases, but not generally recommended, as it is difficult for Svelte to optimise.
+
+```html
+<Widget {...$$props}/>
+```
+
 
 ### Text expressions