# Django Template Tags and Filters

> A reference for Django's 31 built-in template tags and 58 built-in template filters, with examples and commentary on when to use each one.

- Content tracks the Django 6.0 documentation.
- Each entry links to a Markdown rendering of the full page.
- The complete text of every page is available at https://www.djangotemplatetagsandfilters.com/llms-full.txt.

## Template Tags

- [autoescape](https://www.djangotemplatetagsandfilters.com/tags/autoescape.md): turns autoescaping of HTML on or off.
- [block](https://www.djangotemplatetagsandfilters.com/tags/block.md): delineates a block of content that can be overwritten in child templates.
- [comment](https://www.djangotemplatetagsandfilters.com/tags/comment.md): used to comment out code.
- [csp_nonce_attr](https://www.djangotemplatetagsandfilters.com/tags/csp_nonce_attr.md): renders the CSP nonce attribute on `<script>` and `<link>` tags. (Django 6.1)
- [csrf_token](https://www.djangotemplatetagsandfilters.com/tags/csrf_token.md): protects against cross site request forgery.
- [cycle](https://www.djangotemplatetagsandfilters.com/tags/cycle.md): cycles through list of arguments.
- [debug](https://www.djangotemplatetagsandfilters.com/tags/debug.md): outputs debugging information.
- [extends](https://www.djangotemplatetagsandfilters.com/tags/extends.md): signals that the template extends a parent template.
- [filter](https://www.djangotemplatetagsandfilters.com/tags/filter.md): applies a pipe-delimited list of filters to the contained content.
- [firstof](https://www.djangotemplatetagsandfilters.com/tags/firstof.md): returns the first argument in a list of arguments that evaluates to `True`.
- [for](https://www.djangotemplatetagsandfilters.com/tags/for.md): for loop.
- [for … empty](https://www.djangotemplatetagsandfilters.com/tags/for-empty.md): display text when for loop is empty.
- [if](https://www.djangotemplatetagsandfilters.com/tags/if.md): if condition.
- [ifchanged](https://www.djangotemplatetagsandfilters.com/tags/ifchanged.md): checks if value in loop has changed since last iteration.
- [ifequal](https://www.djangotemplatetagsandfilters.com/tags/ifequal.md): **Removed.** Use `{% if a == b %}` instead. (deprecated in Django 3.1)
- [ifnotequal](https://www.djangotemplatetagsandfilters.com/tags/ifnotequal.md): **Removed.** Use `{% if a != b %}` instead. (deprecated in Django 3.1)
- [include](https://www.djangotemplatetagsandfilters.com/tags/include.md): used to include one template in another.
- [load](https://www.djangotemplatetagsandfilters.com/tags/load.md): used to load one or more libraries of tags and filters.
- [lorem](https://www.djangotemplatetagsandfilters.com/tags/lorem.md): outputs *lorem ipsum* placeholder text.
- [now](https://www.djangotemplatetagsandfilters.com/tags/now.md): outputs the current date and/or time.
- [partial](https://www.djangotemplatetagsandfilters.com/tags/partial.md): renders a template fragment defined with `partialdef`. (Django 6.0)
- [partialdef](https://www.djangotemplatetagsandfilters.com/tags/partialdef.md): defines a reusable template fragment. (Django 6.0)
- [querystring](https://www.djangotemplatetagsandfilters.com/tags/querystring.md): outputs a URL-encoded query string. (Django 5.1)
- [regroup](https://www.djangotemplatetagsandfilters.com/tags/regroup.md): used for outputting list of dictionaries in different orders and structures.
- [resetcycle](https://www.djangotemplatetagsandfilters.com/tags/resetcycle.md): used to reset a `cycle`.
- [spaceless](https://www.djangotemplatetagsandfilters.com/tags/spaceless.md): removes irrelevant whitespace between HTML tags.
- [templatetag](https://www.djangotemplatetagsandfilters.com/tags/templatetag.md): Outputs special characters used to create template tags.
- [url](https://www.djangotemplatetagsandfilters.com/tags/url.md): used to output the path to the view mapping to `urlname` as defined in the URLConf file.
- [verbatim](https://www.djangotemplatetagsandfilters.com/tags/verbatim.md): turn off template rendering.
- [widthratio](https://www.djangotemplatetagsandfilters.com/tags/widthratio.md): used to create bar charts and the like.
- [with](https://www.djangotemplatetagsandfilters.com/tags/with.md): caches a variable for reuse.

## Template Filters

- [add](https://www.djangotemplatetagsandfilters.com/filters/add.md): adds `arg` to the value.
- [addslashes](https://www.djangotemplatetagsandfilters.com/filters/addslashes.md): adds backslashes before quotation marks to escape them.
- [capfirst](https://www.djangotemplatetagsandfilters.com/filters/capfirst.md): capitalizes the first letter of a value.
- [center](https://www.djangotemplatetagsandfilters.com/filters/center.md): centers a value within text of `n` characters
- [cut](https://www.djangotemplatetagsandfilters.com/filters/cut.md): removes all instances of `string_to_cut` from the value.
- [date](https://www.djangotemplatetagsandfilters.com/filters/date.md): for formatting dates.
- [default](https://www.djangotemplatetagsandfilters.com/filters/default.md): used to provide a default string when the variable evaluates to `False`.
- [default_if_none](https://www.djangotemplatetagsandfilters.com/filters/default_if_none.md): outputs `default` if and only if the value is `None`.
- [dictsort](https://www.djangotemplatetagsandfilters.com/filters/dictsort.md): sorts a list of dictionaries by `key`.
- [dictsortreversed](https://www.djangotemplatetagsandfilters.com/filters/dictsortreversed.md): reverse sorts a list of dictionaries by `key`.
- [divisibleby](https://www.djangotemplatetagsandfilters.com/filters/divisibleby.md): returns `True` if the value is divisible by `n`.
- [escape](https://www.djangotemplatetagsandfilters.com/filters/escape.md): escapes HTML characters.
- [escapejs](https://www.djangotemplatetagsandfilters.com/filters/escapejs.md): escapes characters used in JavaScript strings.
- [escapeseq](https://www.djangotemplatetagsandfilters.com/filters/escapeseq.md): applies the `escape` filter to each element of a sequence. (Django 5.0)
- [filesizeformat](https://www.djangotemplatetagsandfilters.com/filters/filesizeformat.md): converts a value in bytes to a friendly file size format.
- [first](https://www.djangotemplatetagsandfilters.com/filters/first.md): outputs the first element in a sequence.
- [floatformat](https://www.djangotemplatetagsandfilters.com/filters/floatformat.md): rounds a float to `n` decimal places.
- [force_escape](https://www.djangotemplatetagsandfilters.com/filters/force_escape.md): Almost identical to `escape`.
- [get_digit](https://www.djangotemplatetagsandfilters.com/filters/get_digit.md): returns the digit `i` characters from the right side of the value.
- [iriencode](https://www.djangotemplatetagsandfilters.com/filters/iriencode.md): converts an IRI to a string that can be used in a URL.
- [join](https://www.djangotemplatetagsandfilters.com/filters/join.md): joins a list on `s`. Works just like Python’s `s.join(value)`.
- [json_script](https://www.djangotemplatetagsandfilters.com/filters/json_script.md): outputs a Python object as JSON inside of a `script` element.
- [last](https://www.djangotemplatetagsandfilters.com/filters/last.md): outputs the last element in a sequence.
- [length](https://www.djangotemplatetagsandfilters.com/filters/length.md): returns the length of a value.
- [length_is](https://www.djangotemplatetagsandfilters.com/filters/length_is.md): **Deprecated.** Use `length` with comparison instead. (deprecated in Django 4.2)
- [linebreaks](https://www.djangotemplatetagsandfilters.com/filters/linebreaks.md): converts newlines to `<br>` and `<p>` tags.
- [linebreaksbr](https://www.djangotemplatetagsandfilters.com/filters/linebreaksbr.md): converts all newline characters in `value` to `<br>` tags.
- [linenumbers](https://www.djangotemplatetagsandfilters.com/filters/linenumbers.md): prepends each line of text with a line number.
- [ljust](https://www.djangotemplatetagsandfilters.com/filters/ljust.md): left justifies a value within text of `n` characters
- [lower](https://www.djangotemplatetagsandfilters.com/filters/lower.md): converts a string to lowercase.
- [make_list](https://www.djangotemplatetagsandfilters.com/filters/make_list.md): converts the value to a list of characters.
- [phone2numeric](https://www.djangotemplatetagsandfilters.com/filters/phone2numeric.md): converts letters to numbers for a phone number.
- [pluralize](https://www.djangotemplatetagsandfilters.com/filters/pluralize.md): returns a pluralization suffix.
- [pprint](https://www.djangotemplatetagsandfilters.com/filters/pprint.md): Pretty prints a Python object. Used for debugging.
- [random](https://www.djangotemplatetagsandfilters.com/filters/random.md): outputs a random item from a sequence.
- [rjust](https://www.djangotemplatetagsandfilters.com/filters/rjust.md): right justifies a value within text of `n` characters
- [safe](https://www.djangotemplatetagsandfilters.com/filters/safe.md): indicates that the value is known to be safe and therefore does not need to be escaped.
- [safeseq](https://www.djangotemplatetagsandfilters.com/filters/safeseq.md): applies the `safe` filter to each element of a sequence.
- [slice](https://www.djangotemplatetagsandfilters.com/filters/slice.md): returns a slice of a sequence.
- [slugify](https://www.djangotemplatetagsandfilters.com/filters/slugify.md): converts a string to a slug.
- [stringformat](https://www.djangotemplatetagsandfilters.com/filters/stringformat.md): formats a string.
- [striptags](https://www.djangotemplatetagsandfilters.com/filters/striptags.md): strips HTML tags.
- [time](https://www.djangotemplatetagsandfilters.com/filters/time.md): for formatting times.
- [timesince](https://www.djangotemplatetagsandfilters.com/filters/timesince.md): outputs the amount of time between the value and `to_date`.
- [timeuntil](https://www.djangotemplatetagsandfilters.com/filters/timeuntil.md): outputs the amount of time between `from_date` and the value.
- [title](https://www.djangotemplatetagsandfilters.com/filters/title.md): capitalizes the first letter of each word in a value.
- [truncatechars](https://www.djangotemplatetagsandfilters.com/filters/truncatechars.md): truncates a value to `n` characters and appends an ellipsis (…).
- [truncatechars_html](https://www.djangotemplatetagsandfilters.com/filters/truncatechars_html.md): truncates a value to `n` characters and appends an ellipsis (…). Smart about HTML tags.
- [truncatewords](https://www.djangotemplatetagsandfilters.com/filters/truncatewords.md): truncates a value to `n` words and appends an ellipsis (…).
- [truncatewords_html](https://www.djangotemplatetagsandfilters.com/filters/truncatewords_html.md): truncates a value to `n` words and appends an ellipsis (…). Smart about HTML tags.
- [unordered_list](https://www.djangotemplatetagsandfilters.com/filters/unordered_list.md): creates an unordered HTML list from a Python list of lists.
- [upper](https://www.djangotemplatetagsandfilters.com/filters/upper.md): converts a string to uppercase.
- [urlencode](https://www.djangotemplatetagsandfilters.com/filters/urlencode.md): escapes a string for use in a URL.
- [urlize](https://www.djangotemplatetagsandfilters.com/filters/urlize.md): converts URLs in a string to clickable links by wrapping them in an `<a>` tag.
- [urlizetrunc](https://www.djangotemplatetagsandfilters.com/filters/urlizetrunc.md): like [`urlize`](/filters/urlize/), but truncates the link text.
- [wordcount](https://www.djangotemplatetagsandfilters.com/filters/wordcount.md): outputs the number of words in a value.
- [wordwrap](https://www.djangotemplatetagsandfilters.com/filters/wordwrap.md): inserts newline after every `n` characters.
- [yesno](https://www.djangotemplatetagsandfilters.com/filters/yesno.md): maps `True`, `False`, and `None` to mapped values.