diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 71ac2b19d1..f4e49a9f52 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -359,6 +359,19 @@ The 'ifchanged' block tag is used within a loop. It has two possible uses.
             {% endifchanged %}
         {% endfor %}
 
+The ``ifchanged`` tag can also take an optional ``{% else %}`` clause that
+will be displayed if the value has not changed::
+
+        {% for match in matches %}
+            <div style="background-color:
+                {% ifchanged match.ballot_id %}
+                    {% cycle red,blue %}
+                {% else %}
+                    grey
+                {% endifchanged %}
+            ">{{ match }}</div>
+        {% endfor %}
+
 .. templatetag:: ifequal
 
 ifequal