diff --git a/doc/filters/url_encode.rst b/doc/filters/url_encode.rst
index d3a33fd45..e9c8e2800 100644
--- a/doc/filters/url_encode.rst
+++ b/doc/filters/url_encode.rst
@@ -12,12 +12,16 @@ or an array as query string:
     {{ "path-seg*ment"|url_encode }}
     {# outputs "path-seg%2Ament" #}
 
+    {{ "string with spaces"|url_encode(true) }}
+    {# outputs "string%20with%20spaces" #}
+    
     {{ {'param': 'value', 'foo': 'bar'}|url_encode }}
     {# outputs "param=value&foo=bar" #}
 
 .. note::
 
-    Internally, Twig uses the PHP `urlencode`_ or the `http_build_query`_ function.
+    Internally, Twig uses the PHP `urlencode`_ (or `rawurlencode`_ if you pass ``true`` as the first parameter) or the `http_build_query`_ function.
 
 .. _`urlencode`: http://php.net/urlencode
+.. _`rawurlencode`: http://php.net/rawurlencode
 .. _`http_build_query`: http://php.net/http_build_query