---
id: djlint
version: "1.44.2"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# djlint — HTML template linter and formatter (Django, Jinja, Twig, Nunjucks, Handlebars, Liquid, Go templates)

License: copyleft · Maintenance: active · Downloads: 3.6M/mo

## What it is and what it does

djlint is a command-line formatter and linter designed to fill a gap: while every programming language has formatters and linters, HTML templates are typically left unformatted because generic HTML tools cannot parse template syntax like `{% %}` and `{{ }}`. djlint reads both HTML and template syntax together, with built-in profiles for Django, Jinja, Twig, Nunjucks, Handlebars, Liquid, Go templates, and others.

It reformats templates by fixing indentation, normalizing tag case, splitting long tags into one attribute per line, and collapsing stray blank lines. Its linter catches structural issues that formatting alone cannot fix: orphan tags, missing alt attributes, hard-coded URLs, and dozens of other template-specific checks. The tool is available as a CLI, integrates with pre-commit, and has editor plugins for VS Code and other environments.

Use it for:

- Enforce consistent indentation and formatting across Django or Jinja templates in a web project.
- Catch missing alt attributes, unclosed tags, and other accessibility or structural issues in templates during code review.
- Reformat a large legacy template codebase to a standard style in one pass.
- Integrate template linting into CI/CD pipelines via pre-commit hooks to prevent formatting drift.
- Validate template syntax for multiple template engines (Twig, Nunjucks, Handlebars) in a polyglot project.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

djlint formats and lints HTML templates with embedded template syntax (Django, Jinja, Twig, Nunjucks, Handlebars, Liquid, Go templates, and others), fixing indentation, tag case, spacing, and catching structural issues that generic HTML tools miss.

Yes. djlint is actively maintained, has no known vulnerabilities, low install friction, and solves a real problem—template formatting and linting that generic HTML tools cannot handle. The GPL-3.0-or-later license is copyleft, so verify compatibility with your project's license before bundling; development and CI/CD use are unaffected. Recommended for any project using Django, Jinja, or other templated HTML.

## Install

pip install djlint
uv add djlint
poetry add djlint

## Installing djlint

Before you install: Low friction: pure Python wheel with 9 runtime dependencies (click, cssbeautifier, jsbeautifier, json5, pathspec, pyyaml, regex, tomli, typing-extensions). Active maintenance—last release 6 days ago, repository updated 2026-08-14, 944 stars.

License in practice: GPL-3.0-or-later (copyleft): you may use djlint freely, but any derivative work or distribution must also be GPL-3.0-or-later. Acceptable for development and CI/CD; review your project's license compatibility before bundling.

Quickstart:

pip install djlint

djlint . --reformat --single-attribute-per-line --profile=django
djlint . --lint

Requires Python 3.10 or later.

Verify before relying:

- Performance characteristics on large template codebases or real-world project sizes.
- Completeness of linting rules for each template engine profile (Django, Jinja, Twig, etc.).
- Whether the tool integrates with popular CI/CD platforms beyond pre-commit.

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

html template formatter, django template linter, jinja template formatter, template syntax linter, html indentation fixer, template engine formatter, twig template linter, template-linting, html-formatter, django-tools

[View on SkillFed](https://skillfed.io/packages/djlint) · [View on PyPI](https://pypi.org/project/djlint/)