369

models.py:

class Person(models.Model):
    name = models.CharField(max_length=200)
    CATEGORY_CHOICES = (
        ('M', 'Male'),
        ('F', 'Female'),
    )
    gender = models.CharField(max_length=200, choices=CATEGORY_CHOICES)
    to_be_listed = models.BooleanField(default=True)
    description = models.CharField(max_length=20000, blank=True)

views.py:

def index(request):
    latest_person_list2 = Person.objects.filter(to_be_listed=True)
    return object_list(request, template_name='polls/schol.html',
                       queryset=latest_person_list, paginate_by=5)

On the template, when I call person.gender, I get 'M' or 'F' instead of 'Male' or 'Female'.

How to display the value ('Male' or 'Female') instead of the code ('M'/'F')?

6
  • 5
    possible duplicate of Django print choices value Commented Dec 1, 2010 at 2:30
  • 2
    I tried this method, In my template I am using: {% for person in object_list %} some html {{person.get_gender_display() }} html {% endfor %} I am getting the following error: Exception Value: Could not parse the remainder: '()' from 'person.get_gender_display()'
    – Shankze
    Commented Dec 1, 2010 at 3:29
  • 9
    My Bad, I should not have included '()' after person.get_gender_display. Its working now. Thanks.
    – Shankze
    Commented Dec 1, 2010 at 3:35
  • 4
    Just a little comment, since gender will only be either M or F(1 character lenght) it has no sense setting the max length of the charfield to 200. With max_lenght=1 is enough, will make your site more efficient and you will ensure that you wont have wrong data. :) Commented Mar 31, 2013 at 23:15
  • Possible duplicate of Django templates: verbose version of a choice Commented May 15, 2016 at 11:48

4 Answers 4

708

It looks like you were on the right track - get_FOO_display() is most certainly what you want:

In templates, you don't include () in the name of a method. Do the following:

{{ person.get_gender_display }}
10
  • This method is priceless. But aside using the method, what's the way to retrieve the value stored in say, {{ i.item.what_to_put_here}} ?
    – KhoPhi
    Commented Apr 18, 2015 at 23:15
  • 17
    Just to note, for anyone using Jinja2 for their templates, you should include the parentheses. {{ person.get_gender_display() }}
    – adam b
    Commented Mar 10, 2016 at 16:27
  • 1
    Bonus points: what's the best way to do this if you're sending your information via JSON (for instance in a pagination scenario)? Ideally without the overhead of instantiating the Models one by one and calling get_field_display().
    – DylanYoung
    Commented Mar 23, 2017 at 17:34
  • 9
    Gotta love Django, almost 10 years later and the answer is still valid! Thx +1 and drink on me.
    – Marc
    Commented Oct 7, 2017 at 0:51
  • 1
    Somehow this doesn't fetch the translated text. Any idea on how to get the translated text if i18 is already implemented on the website?
    – Anoop Nair
    Commented Feb 13, 2020 at 12:43
58

For every field that has choices set, the object will have a get_FOO_display() method, where FOO is the name of the field. This method returns the “human-readable” value of the field.

In Views

person = Person.objects.filter(to_be_listed=True)
context['gender'] = person.get_gender_display()

In Template

{{ person.get_gender_display }}

Documentation of get_FOO_display()

0

I do this by defining constants the following way:

class Person(models.Model):
    MALE = 'M'
    FEMALE = 'F'
    CATEGORY_CHOICES = (
        (MALE, 'Male'),
        (FEMALE, 'Female'),
    )

    name = models.CharField(max_length=200)
    gender = models.CharField(max_length=200, choices=CATEGORY_CHOICES)
    to_be_listed = models.BooleanField(default=True)
    description = models.CharField(max_length=20000, blank=True)

The M and F values will be stored in the database, while the Male and Female values will display everywhere.

-2

Others have pointed out that a get_FOO_display method is what you need. I'm using this:

def get_type(self):
    return [i[1] for i in Item._meta.get_field('type').choices if i[0] == self.type][0]

which iterates over all of the choices that a particular item has until it finds the one that matches the items type

2
  • 1
    You can also use Product.category.field.choices
    – lcjury
    Commented Sep 10, 2022 at 6:47
  • Why reinvent the wheel? get__field__display() does it auto
    – Shayne
    Commented Jun 24 at 6:22

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.