Skip to content
A simple Django app that adds search and sort to HTML tables.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A simple Django app that adds search and sort to HTML tables.

I like using simple views, but it should work with class-based views as well (but I haven't tested it).


Add searchly_tables to your INSTALLED_APPS:


In your, import searchly_tables, add a new table to a view, and specify for which model you would like to use it:

from django.shortcuts import render

from example.model import ExampleModel
from searchly_tables.tables import SearchlyTable

def view(request):
	table = SearchlyTable(module="exampleapp.models", model="ExampleModel", field_filters=field_filters)
	table.labels = {'baseField1': 'labelForBaseField1', 'foreignkey_relationship': 'labelForForeignKeyRelationship', 'baseField2': 'labelForBaseField2'}

	# Optional links to models in fields
	table.field_links = {'baseField2': ['app:view', 'url_parameter']}
	if request.POST:, filter=True, sort=True)
	return render(request, 'example/table.html', {'table': table})

Then add the table to your template like this:

<form action="#" method=POST>
	{% csrf_token %}
	{{ table.searchbar|safe }}
		{{ table.header|safe }} {{ table.body|safe }}

And that's it! Naturally, you can change the appearance of the table by applying CSS.

For instance table.attrs['td'] = 'my_td_class' would result in <td class="my_td_class"> on all td elements in the table. Django-searchly-tables currently only supports classes; sorry, no direct styles as of yet. Also no direct access to a single element by id for most elements; the sole exception is <td>.

Here's the list of elements I use in the table:

thead, tbody, tr, th, td, input, button, select, option


Should I use this?

Maybe? Probably not?

It's a super basic app with very little fuzz. The code is still all over the place. If that's for you, cool. If you need more options in your tabling(?), you should check out django_tables2.

Another table app? Haven't you heard about django_tables2? It's way better and has tons of features!

Yep, I agree. I even linked to it in my earlier answer!

So, will this support feature X in the future? I really need that.

Probably not? I'm happy with the way it works now, apart from some minor issues (=code cleanup/documentation). But you're welcome to fork it, if you need feature X. Or use django_tables2 (seriously, it's great!).

You can’t perform that action at this time.