TypeError: args or kwargs must be provided with {% jazzmin_paginator_number %} on Django 6

[aminegit2018]

Description:
When I try to open the Employe model in Django admin using Jazzmin, I get the following error:

Exception Type: TypeError
Exception Value: args or kwargs must be provided
26 {% jazzmin_paginator_number cl i %}

Environment:

Django version: 6.0

django-jazzmin version: 3.0.1

Python version: 3.13

Browser: Edge

Steps to reproduce:

Install Django 6.0 and Jazzmin 3.0.1.

Register a model in admin (e.g., Employe). and insert enough data for the pagination
Open the model list page in the admin.

Expected behavior:
Pagination should work without errors.

Actual behavior:
The page raises a TypeError in the template:

{% jazzmin_paginator_number cl i %}

Additional context:

my project works fine on django 5.2

The error seems to be related to Django 6 changes in URL reversal for pagination.

Suggested fix:
Update the pagination template and/or tag to be compatible with Django 6.

[nikklavzar]

As a workaround, I added this patch to run on the app ready callback in apps.py.

class CoreConfig(AppConfig):
    default_auto_field = "django.db.models.BigAutoField"
    name = "core"

    def ready(self):
        self._patch_jazzmin_paginator()

def _patch_jazzmin_paginator(self):
    """
    Patch jazzmin's paginator to work with Django 6.0.

    django-jazzmin 3.0.1 calls format_html(html_str) without args, which is
    not allowed in Django 6.0. This patches the affected function to use mark_safe.
    See: https://code.djangoproject.com/ticket/34609
    """
    try:
        from django.contrib.admin.views.main import PAGE_VAR
        from django.utils.safestring import mark_safe
        from jazzmin.templatetags import jazzmin as jazzmin_tags

        def patched_jazzmin_paginator_number(cl, i):
            """Patched version that uses mark_safe instead of format_html."""
            if i == "." or i == "…":
                html_str = (
                    '<li class="page-item disabled"><a class="page-link" href="#">...</a></li>'
                )
            elif i == cl.page_num:
                html_str = (
                    f'<li class="page-item active"><a class="page-link" href="#">{i}</a></li>'
                )
            else:
                link = cl.get_query_string({PAGE_VAR: i})
                html_str = (
                    f'<li class="page-item"><a class="page-link" href="{link}">{i}</a></li>'
                )

            return mark_safe(html_str)

        # Apply the patch
        jazzmin_tags.jazzmin_paginator_number = patched_jazzmin_paginator_number
        # Also register it in the template library
        jazzmin_tags.register.simple_tag(
            patched_jazzmin_paginator_number, name="jazzmin_paginator_number"
        )
        logger.debug("Applied jazzmin_paginator_number patch for Django 6.0 compatibility")
    except ImportError:
        pass  # jazzmin not installed

[aminegit2018]

Thanks for sharing the workaround, I'll definitely be using it to upgrade my project to Django 6.0.

[RyanLoil]

For me, no need to use the patch but you need to edit the source file of jazzmin.

1. Go to the templatetags/jazzmin.py, it should be hinted on your debug page.
2. Find line 256, change it to return mark_safe(html_str) # format_html(html_str)

This is a temporary fix for it.

[nikklavzar]

For me, no need to use the patch but you need to edit the source file of jazzmin.

1. Go to the templatetags/jazzmin.py, it should be hinted on your debug page.
2. Find line 256, change it to return mark_safe(html_str) # format_html(html_str)

This is a temporary fix for it.

The script basically does this, just dynamically. I didn't want to pull the dependency repository and install it from source, easier to just remove the patch when updating. But if that is no issue, then this works

[Ca-tt]

Huge thank you for your solution!

As a workaround, I added this patch to run on the app ready callback in apps.py.