Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
63 lines (36 sloc) 2.47 KB


The SmartListView provides the most bang for the buck, and was largely inspired by Django's own admin list API. It has the following options:


Defines which fields should be displayed in the list, and in what order.

The order of precedence to get the field value is first the View, by calling get_${field_name}, then the object itself. This means you can easily define custom formatting of a field for a list view by simply declaring a new method:

class PostListView(SmartListView):
  model = Post
  fields = ('title', 'body')

  def get_body(self, obj):
    # only display first 50 characters of body
    return obj.body[:50]

Note that if you'd like to have this be set at runtime, you can do so by overriding the derive_fields method


Defines which fields should be turned into links to the object itself. By default, this is just the first item in the field list, but you can change it as you wish, including having more than one field. By default Smartmin will generate a link to the 'read' view for the object.

You can modify what the link is by overriding lookup_field_link:

class List(SmartListView):
  model = Country
  link_fields = ('name', 'currency')

  def lookup_field_link(self, context, field, obj):
    # Link our name and currency fields, each going to their own place
    if field == 'currency':
      return reverse('locales.currency_update', args=[])
      return reverse('locales.country_update', args=[])

Note that if you'd like to have this be set at runtime, you can do so by overriding the derive_link_fields method


If set, then enables a search box which will search across the passed in fields. This should be a list or tuple. The values are used to build up a Q object, so you can specify standard Django manipulations if you'd like:

class List(SmartListView):
  model = User
  search_fields = ('username__icontains','first_name__icontains', 'last_name__icontains')

Alternatively, if you want to customize the search even further, you can modify how the query is built by overriding the derive_queryset method.


The name of the template used to render this view. By default, this is set to smartmin/list.html but you can override it to whatever you'd like.


Whether an add button should be automatically added for this list view. Generally used with CRUDL.

Something went wrong with that request. Please try again.