Django — Pagination

Basic Pagination

from django.core.paginator import Paginator

def post_list(request):
    posts = Post.objects.all()
    paginator = Paginator(posts, 10)  # 10 per page
    
    page_number = request.GET.get('page')
    page_obj = paginator.get_page(page_number)
    
    return render(request, 'blog/list.html', {'page_obj': page_obj})

Template

<div class="pagination">
    {% if page_obj.has_previous %}
        <a href="?page=1">&laquo; First</a>
        <a href="?page={{ page_obj.previous_page_number }}">Previous</a>
    {% endif %}
    
    <span>Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}</span>
    
    {% if page_obj.has_next %}
        <a href="?page={{ page_obj.next_page_number }}">Next</a>
        <a href="?page={{ page_obj.paginator.num_pages }}">Last &raquo;</a>
    {% endif %}
</div>

Paginator Methods

Method	Description
get_page()	Get page safely
num_pages	Total pages
page_range	Range of page numbers
count	Total items

Page Methods

Method	Description
has_previous()	Has previous page
has_next()	Has next page
previous_page_number()	Previous page number
next_page_number()	Next page number
object_list	Items on page

Mini Practice

1. Paginate a queryset
2. Create pagination template
3. Handle page navigation
4. Style pagination links

Up Next

Continue with Class-Based Views — using class-based views.