diff --git a/README.md b/README.md
index 80f054673..30ac5688b 100644
--- a/README.md
+++ b/README.md
@@ -642,6 +642,12 @@ Input data passed to a template is made available using a special `data` variabl
 <var name="name" value="data.name.toUpperCase()" />
 ```
 
+To reassigne an existing variable with a new value always use the `<assign>` tag. For example:
+```html
+<assign var="name" value="data.lastname" />
+```
+
+
 The `<with>` directive can be used to create scoped variables as shown in the following sample code:
 
 ```html