Home » Django » How do I add multiple arguments to my custom template filter in a django template?

How do I add multiple arguments to my custom template filter in a django template?

Posted by: admin November 30, 2017 Leave a comment


Here’s my custom filter:

from django import template

register = template.Library()

def replace(value, cherche, remplacement):
    return value.replace(cherche, remplacement)

and here are the ways I tried using it in my template file that resulted in an error:

{{ attr.name|replace:"_"," " }}
{{ attr.name|replace:"_" " " }}
{{ attr.name|replace:"_":" " }}
{{ attr.name|replace:"cherche='_', remplacement=' '" }}

I looked into django’s docs and book but only found example using a single argument… is it even possible?


It is possible and fairly simple.

Django only allows one argument to your filter, but there’s no reason you can’t put all your arguments into a single string using a comma to separate them.

So for example, if you want a filter that checks if variable X is in the list [1,2,3,4] you will want a template filter that looks like this:

{% if X|is_in:"1,2,3,4" %}

Now we can create your templatetag like this:

from django.template import Library

register = Library()

def is_in(var, args):
    if args is None:
        return False
    arg_list = [arg.strip() for arg in args.split(',')]
    return var in arg_list


The line that creates arg_list is a generator expression that splits the args string on all the commas and calls .strip() to remove any leading and trailing spaces.

If, for example, the 3rd argument is an int then just do:

arg_list[2] = int(arg_list[2])

Or if all of them are ints do:

arg_list = [int(arg) for arg in args.split(',')]

EDIT: now to specifically answer your question by using key,value pairs as parameters, you can use the same class Django uses to parse query strings out of URL’s, which then also has the benefit of handling character encoding properly according to your settings.py.

So, as with query strings, each parameter is separated by ‘&’:

{{ attr.name|replace:"cherche=_&remplacement= " }}

Then your replace function will now look like this:

from django import template
from django.http import QueryDict

register = template.Library()

def replace(value, args):
    qs = QueryDict(args)
    if qs.has_key('cherche') and qs.has_key('remplacement'):
        return value.replace(qs['cherche'], qs['remplacement'])
        return value

You could speed this up some at the risk of doing some incorrect replacements:

qs = QueryDict(args)
return value.replace(qs.get('cherche',''), qs.get('remplacement',''))


Not possible according to this section of the docs:

Custom filters are just Python functions that take one or two arguments:

  • The value of the variable (input) —
    not necessarily a string.
  • The value of the argument — this can have a
    default value, or be left out altogether.

Instead of a filter, register your tag as a simple tag. Those can take multiple arguments. The syntax for invoking it will be a little bit different, but that’s just syntactic sugar changing.


It’s easy like this.

def one_more(_1, _2):
    return _1, _2

def your_filter(_1_2, _3)
    _1, _2 = _1_2
    print "now you have three arguments, enjoy"

{{ _1|one_more:_2|your_filter:_3 }}



from django.template import Library

import re

register = Library()

def search(value, search):
    return re.sub(search, '#[email protected]', value)

def replace(value, replace):
    return re.sub('#[email protected]', replace, value)


In the template:

{{ "saniel"|search:"s"|replace:"d" }}


This feature has been marked as WONTFIX in 2013 Django’s Trac: http://code.djangoproject.com/ticket/1199


Heres a bad idea but works:

{{ xml|input_by_xpath:"{'type':'radio','xpath':'//result/value'}" }}


def input_by_xpath(device, args): 
    args = eval(args)
    result = "<input type=\"%s\" value=\"%s\" name=\"%s\"/>"%(args['type'],value,args['xpath'])
    return mark_safe(result)