diff --git a/vlib/vweb/tmpl/README.md b/vlib/vweb/tmpl/README.md
index 48d6c2544f..6284593917 100644
--- a/vlib/vweb/tmpl/README.md
+++ b/vlib/vweb/tmpl/README.md
@@ -108,6 +108,19 @@ Project root
 ```
 > Note that there shouldn't be a file suffix,
     it is automatically appended and only allows `html` files.
+    
+    
+## js
+The js directive consists of two parts, the `@js` tag and `'<path>'` string,
+where you can insert your src
+```
+@js '<url>'
+```
+
+### Example
+```html
+@js 'myscripts.js'
+```
 
 # Variables
 All variables which are declared before can be used through the `@{my_var}` syntax.