# jazzband/django-widget-tweaks

Tweak the form field rendering in templates, not in python-level form definitions. CSS classes and HTML attributes can be altered.

Repository: https://github.com/jazzband/django-widget-tweaks
Canonical: https://ross.abutalabs.com/products/django-widget-tweaks
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-24T17:41:35+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 5294, "days_push": 9, "days_rel": 495, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2163, forks 137 (observed 2026-08-28T04:06:21.154569+00:00)

## What it is
A Django app providing template tags and filters for tweaking form field rendering directly in templates, allowing CSS classes and HTML attributes to be altered without touching Python form definitions. It lets designers customize field presentation using an HTML-like syntax.

## Use cases
- add css classes to django form fields in templates
- customize form field html attributes without changing python forms
- render django form fields with html-like syntax
- let designers style form fields without touching backend code
- add placeholder or input type attributes to django widgets
- apply error and required css classes to form fields

## When to choose
- you use Django templates and want to tweak form field HTML from the template layer
- designers or front-end developers need to adjust form presentation without Python changes
- you need to append CSS classes or set HTML5 attributes on form inputs

## When to avoid
- you don't use Django or its template engine
- you need deep widget customization better handled in Python form/widget definitions
- your forms are rendered client-side with a JavaScript framework

## Facets
- artifact type: library
- maturity: stable
- function: templating, form-handling, ui-components
- domain: web-development, frontend, backend
- platform: python
- tags: django, template-tags, form-rendering, css-classes, html-attributes, web-server

## Member repositories
- jazzband/django-widget-tweaks (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:21.154569+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:50:12.002729+00:00, confidence not recorded.
  - readme: https://github.com/jazzband/django-widget-tweaks (fetched 2026-08-28T04:06:21.154569+00:00, sha 01d867ac5411)
  - registry_pypi: https://pypi.org/pypi/django-widget-tweaks/json (fetched 2026-08-29T10:29:53.253761+00:00, sha fb60c8d067dc)
- Data as of 2026-08-30T08:39:29.467469+00:00.