--- /dev/null
+``trim``
+========
+
+.. versionadded:: 1.32
+ The ``side`` argument was added in Twig 1.32.
+
+.. versionadded:: 1.6.2
+ The ``trim`` filter was added in Twig 1.6.2.
+
+The ``trim`` filter strips whitespace (or other characters) from the beginning
+and end of a string:
+
+.. code-block:: jinja
+
+ {{ ' I like Twig. '|trim }}
+
+ {# outputs 'I like Twig.' #}
+
+ {{ ' I like Twig.'|trim('.') }}
+
+ {# outputs ' I like Twig' #}
+
+ {{ ' I like Twig. '|trim(side='left') }}
+
+ {# outputs 'I like Twig. ' #}
+
+ {{ ' I like Twig. '|trim(' ', 'right') }}
+
+ {# outputs ' I like Twig.' #}
+
+.. note::
+
+ Internally, Twig uses the PHP `trim`_, `ltrim`_, and `rtrim`_ functions.
+
+Arguments
+---------
+
+* ``character_mask``: The characters to strip
+
+* ``side``: The default is to strip from the left and the right (`both`) sides, but `left`
+ and `right` will strip from either the left side or right side only
+
+.. _`trim`: http://php.net/trim
+.. _`ltrim`: http://php.net/ltrim
+.. _`rtrim`: http://php.net/rtrim