GitPedia

Django tables2

django-tables2 - An app for creating HTML tables

From jieter·Updated June 3, 2026·View on GitHub·

django-tables2 simplifies the task of turning sets of data into HTML tables. It has native support for pagination and sorting. It does for HTML tables what `django.forms` does for HTML forms. e.g. The project is written primarily in Python, distributed under the Other license, first published in 2010. It has gained significant community traction with 2,015 stars and 444 forks on GitHub. Key topics include: django, python, sorting, tables, tableview.

django-tables2 - An app for creating HTML tables

Latest PyPI version
Any color you like

django-tables2 simplifies the task of turning sets of data into HTML tables. It
has native support for pagination and sorting. It does for HTML tables what
django.forms does for HTML forms. e.g.

Features:

  • Any iterable can be a data-source, but special support for Django QuerySets is included.
  • The builtin UI does not rely on JavaScript.
  • Support for automatic table generation based on a Django model.
  • Supports custom column functionality via subclassing.
  • Pagination.
  • Column based table sorting.
  • Template tag to enable trivial rendering to HTML.
  • Generic view mixin.

An example table rendered using django-tables2

An example table rendered using django-tables2 and bootstrap theme

An example table rendered using django-tables2 and semantic-ui theme

Example

Start by adding django_tables2 to your INSTALLED_APPS setting like this:

python
INSTALLED_APPS = ( ..., "django_tables2", )

Creating a table for a model Simple is as simple as:

python
import django_tables2 as tables class SimpleTable(tables.Table): class Meta: model = Simple

This would then be used in a view:

python
class TableView(tables.SingleTableView): table_class = SimpleTable queryset = Simple.objects.all() template_name = "simple_list.html"

And finally in the template:

{% load django_tables2 %}
{% render_table table %}

This example shows one of the simplest cases, but django-tables2 can do a lot more!
Check out the documentation for more details.

Contributors

Showing top 12 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from jieter/django-tables2 via the GitHub API.Last fetched: 6/15/2026