Getting started


Python >= 2.6 (or Python 3)
Django >= 1.3
jQuery >= 1.7


The Git repository can be cloned with this command:

git clone

The simple_pagination package, included in the distribution, should be placed on the PYTHONPATH.

Otherwise you can just easy_install -Z django-simple-pagination or pip install django-simple-pagination.


Add the request context processor to your, e.g.:

from django.conf.global_settings import TEMPLATE_CONTEXT_PROCESSORS

Add 'simple_pagination' to the INSTALLED_APPS to your

See the Settings section for other settings.


Given a template like this:

{% for item in items %}
    {# your code to show the item #}
{% endfor %}

you can use simple Digg-style pagination to display objects just by adding:

{% load paginate %}

{% paginate items %}
{% for item in items %}
    {# your code to show the item #}
{% endfor %}
{% show_pageitems %}


This is just a basic example. To continue exploring all the Django Simple Pagination features, have a look at Simple pagination.