Changelog

Unreleased

  • Say in MAINTAINING.md that just release-check reporting no Unreleased entries straight after a cut means nothing is pending, not that the changelog was lost.

  • Add .gitattributes with * text=auto, so the repository stores text files with LF whatever the committing machine used. .editorconfig asked for this and could not enforce it.

  • Drop max_line_length for Python from .editorconfig. It said 88 while ruff enforces 120, so an editor honouring it flagged code that passes lint.

  • Store src/bootstrap4/widgets.py with LF line endings. It was the only file in the repository with CRLF, and .gitattributes renormalises it.

  • Fail just lint on trailing whitespace, and strip it in just format. .editorconfig asked for it and nothing enforced it, so it depended on each person’s editor. Markdown hard line breaks, which are exactly two trailing spaces, are preserved.

  • Fail just lint if CHANGELOG.md has more than one ## Unreleased heading, or has it below a released section. Branches that each add the heading merge without a conflict.

26.3 (2026-10-11)

  • Breaking: Drop support for Python 3.10, end of life since 2026-10-01. The floor is now Python 3.11.

  • Breaking: Fix invalid HTML in RadioSelectButtonGroup. Every option label carried the widget’s own id, so a group of N options rendered N+1 identical id attributes and no label was associated with its input. Labels now carry for pointing at their own input and no id (#309).

  • Fix RadioSelectButtonGroup not rendering as a button group. The renderer replaced the class attribute of a widget’s enclosing element instead of adding to it, discarding btn-group btn-group-toggle. Django’s own RadioSelect and CheckboxSelectMultiple set no class there, so their output is unchanged (#894).

  • Fix {% buttons layout="horizontal" %} emitting Bootstrap 3 markup: the label carried control-label instead of col-form-label, and the wrapper had no row for the col-* classes to divide, so the button did not line up with the fields above it (#895).

  • Fix form_check_class being ignored for single checkboxes; it was only applied to RadioSelect and CheckboxSelectMultiple (#290).

  • Fix show_label and label_class being ignored for the label next to a checkbox. show_label=False and show_label='sr-only' now add sr-only, show_label='skip' omits the label, and label_class extends form-check-label instead of being dropped (#127).

  • Fix size not being applied to the input group wrapper when a field has an addon, so input-group-sm and input-group-lg were missing and the addon rendered at the wrong height (#128).

  • Add a system check that warns about keys in the BOOTSTRAP4 setting that the package does not read, such as base_url, dropped in 0.0.8 (bootstrap4.W001, #883). Silence it with SILENCED_SYSTEM_CHECKS if you keep extra keys deliberately.

  • Remove the <7.0 upper bound on the Django dependency.

  • Test on Python 3.15 (release candidate) against Django 6.1 and main. The job is non-blocking and 3.15 is not yet advertised as supported.

  • Fail the CI gate when any job fails, not only the test matrix. A failing docs or packaging build could previously be merged.

  • Cover renderers.py, components.py and the template tags with tests, and hold the line at 100%. InlineFieldRenderer had no tests at all, nor did the SelectDateWidget, file input and ReadOnlyPasswordHashWidget markup fixes, the non-dismissible alert, formset-level errors, {% buttons reset=... %}, or the asset tags with a URL set to None. coverage report now fails below 100%, matching django-marina, django-bootstrap5, django-icons and django-bootstrap3.

  • Cover utils.py, forms.py and text.py with tests. handle_var, parse_token_contents, remove_css_class, render_link_tag, every render_button size and optional attribute, the standalone error renderers, render_field_and_label in horizontal layout, and text_concat had no tests.

  • Cover pagination with tests. get_pagination_context and the bootstrap_pagination and bootstrap_url_replace_param tags had no tests at all.

  • Remove an unreachable guard in get_pagination_context: pages_to_show is already an integer of at least one by that point, so the half window cannot be negative.

  • Add just release-check, which lists the commits since the last tag next to the current Unreleased entries, in two groups: those touching src/, and those touching nothing in src/. Tooling, CI and documentation changes ship too, and a list filtered to src/ read as a complete one.

  • Fail just build when uv.lock does not name the version in pyproject.toml, and add just relock to fix it. uv sync --frozen does not check the project’s own version, so a stale lock passed every packaging check.

  • Run coverage report in CI, so the 100% floor can actually fail a build rather than only a local run (#904).

  • Harden the workflows against the findings of a zizmor audit: the Dependabot job gates on the pull request author rather than github.actor, ci.yml declares contents: read instead of inheriting a write-capable token, and the publishing job no longer restores a shared cache. Restore the timeout-minutes the Dependabot and release jobs had lost (#900).

  • Fail just lint on invisible and bidirectional control characters, which do not render in a diff and can therefore hide code (Trojan Source, CVE-2021-42574). Two were removed from docs/settings.rst (#888).

  • Fix stale Bootstrap 3 class names in the bootstrap_field docs: error_css_class defaults to is-invalid and bound_css_class to is-valid, and the label gets col-form-label in horizontal layout, not control-label.

  • Document why bound forms, including GET filter forms, render is-valid on every field, and how to switch that off (#276).

  • Document that use_i18n in BOOTSTRAP4 is always overwritten by Django’s USE_I18N.

  • Add the shared AI assistance policy to CONTRIBUTING.md, and the dependency update policy to MAINTAINING.md (#887, #900).

  • Add a CLAUDE.md shim so Claude Code loads AGENTS.md, and trim AGENTS.md to what a session cannot read from the repo itself (#885).

26.2 (2026-08-28)

  • Drop support for Django 4.2 (EOL).

  • Add support for Django 6.1.

  • Fix KeyError in url_replace_param when clearing a parameter that is not present in the URL (#862).

  • Add a maintenance-round section and release-note ordering convention to MAINTAINING.md.

  • Add a 15-minute timeout-minutes to every CI job.

  • Add typos spell checking to just lint.

  • Regenerate uv.lock (stale Django >=4.2 constraint in the lockfile’s own metadata after the pyproject.toml floor moved to >=5.2).

  • Add MAINTAINING.md (version-support policy, release process); add scope statement and PR-review checklist to CONTRIBUTING.md.

  • Add AGENTS.md (#862).

  • Fix typos in CHANGELOG.md.

26.1 (2026-01-03)

  • Refactor release workflow to tag-based publishing via GitHub Actions (#843).

  • Remove support for Django 5.1 (EOL) (#840).

25.3 (2025-11-14)

  • Remove support for Python 3.9 (EOL) (#833, #835).

  • Add support for Python 3.14 (#831).

  • Add support for Django 6.0 (#830).

25.2 (2025-07-31)

  • Symlink CHANGELOG.md into docs for Sphinx (#812).

  • Drop support for Django 5.0 (EOL) (#814).

  • Add support for Django 5.2 (#815).

  • Use astral-sh/setup-uv in GitHub Actions (#820, #821).

  • Use uv build (#822).

  • Use uv.lock in GitHub Actions (#823).

25.1 (2025-03-01)

  • Announce maintenance mode (#808).

  • Switch to just and uv (#805).

  • Remove Python 3.8, add Python 3.13 (#805).

24.4 (2024-09-19)

  • Add support for Django 5.1 (#758).

24.3 (2024-04-17)

  • Reinstate setuptools_scm for build (#707).

24.2 (2024-04-16)

  • Remove setuptools_scm (#704).

  • Fix Read the Docs (#703).

  • Remove support for Django 3.2 (EOL).

24.1 (2024-01-29)

  • Fix CheckboxSelectMultiple on Django>4 (#672, @heso).

23.4 (2023-12-28)

  • Use setuptools-scm to build package (#664).

23.3 (2023-12-24)

  • Use ruff instead of black for formatting (#653).

  • Add support for Python 3.12 (#658).

  • Add support for Django 5.0 (#658).

  • Revert packaging tools to setuptools, build, tox and twine (#658).

23.2 (2023-06-28)

  • Fix references to example application (#648).

  • Remove support for Python 3.7 (EOL) (#646).

  • Switch to Hatch (#638).

  • Fix readthedocs (#603).

  • Remove version restriction on importlib-metadata (#604).

  • Replace m2r2 with sphinx-mdinclude (#605).

23.1 (2023-04-05)

  • Add support for Django 4.2 (#601).

  • Update requirements and packages (#601).

  • Stop using coveralls (#601).

22.3 (2022-11-23)

  • Add support for Python 3.11 (#554).

22.2 (2022-08-08)

  • Update Bootstrap to 4.6.2 (#499).

  • Drop support for Django 2.2 (EOL) (#500).

  • Add support for Django 4.1 (#500).

22.1 (2022-03-07)

  • Add support for Django 4 (#447).

  • Fix urls in example (#418, #444).

21.2 (2021-12-27)

  • Drop support for Django 4 (#398).

  • Drop support for Django 3.1 (EOL, #399).

  • Drop support for Python 3.6 (EOL, #399).

  • Fix CI.

21.1 (2021-11-03)

  • Switch to a CalVer YY.MINOR versioning scheme. MINOR is the number of the release in the given year. This is the first release in 2021 using this scheme, so its version is 21.1. The next version this year will be 21.2. The first version in 2022 will be 22.1.

  • Add support for Django 4.0 and Python 3.10 (#349).

  • Fix faulty example code (#347).

3.0.1 (2021-05-01)

  • No line break in FileInput in horizontal layout.

  • Actually use the bundles JavaScript.

3.0.0 (2021-04-09)

  • Drop support for Django 3.0, extended support stopped on 2021-04-01).

  • Add support for Django 3.2.

  • Use bundled Bootstrap JavaScript, no need for separate popper.js.

  • Updated default Bootstrap to 4.6.0.

  • Add Dependabot for updates to dependencies.

  • Rename AUTHORS.md to AUTHORS, remove authors section from documentation.

  • Revert to setuptools for packaging.

  • Add Python 3.9 to Travis CI.

  • Add docs and tests to sdist.

  • Use GitHub Actions for CI.

  • Fix example by not installing editable version.

2.3.1 (2020-10-16)

  • Fix CHANGELOG.

2.3.0 (2020-10-11)

  • Updated default Bootstrap to 4.5.2.

  • Updated CSS/JavaScript URLs to newer versions (thanks @emmceemoore).

  • Replace m2r with m2r2 to support Sphinx3.

  • Update Sphinx dependency because of security update.

  • Use Django 3.1 in tox matrix, fix warning in tests.

  • Add tox to development dependencies.

  • Accept importlib-metadata 2.x.x (thanks @dbaty).

  • Add Python 3.9 to tox matrix.

2.2.0 (2020-07-01)

  • Fix coveralls.

  • Add Django 3.1 to tox matrix.

2.1.1 (2020-06-18)

  • Fix date in CHANGELOG.

  • Fix typo in pyproject.toml (#222).

2.1.0 (2020-06-17)

  • Convert HISTORY.rst to Markdown and rename to CHANGELOG.md.

  • Convert README.rst, AUTHORS.rst and CONTRIBUTING.rst to Markdown, and change extension to .md.

  • Update CONTRIBUTING.md to reflect use of poetry.

  • Drop contributing.rst from documentation.

  • Rename default branch ‘master’ to ‘main’.

2.0.1 (2020-06-02)

  • Set beautifulsoup4 requirement to >= 4.8.0 (fixes #216).

  • Do not assume all inputs are inside labels (fixes #215).

2.0.0 (2020-06-01)

  • Use poetry (https://python-poetry.org/) for dependency management and packaging.

  • Drop support for Python 3.5.

  • Fix form-check-{label,input} classes applied too broadly. These should only be applied to labels and inputs found underneath the enclosing widget div for radio and checkbox select, not on the whole document.

  • Allow to display radio and checkbox elements inline using the form-check classes.

1.1.2 (2019-12-13)

  • Restructure tox and Makefile.

  • Add test for bootstrap4.__version__.

1.1.1 (2019-12-11)

  • Remove tag command from Makefile.

  • Reinstate bootstrap4.__version__ (#186).

  • Add test for using a different jQuery version (#184).

1.1.0 (2019-12-09)

  • Update default Bootstrap to v4.3.1.

  • Add support for Python 3.8, Django 3 and Django master.

  • Switch to Django manage.py for test running.

  • Update Makefile commands.

  • Update tox configuration.

  • Use correct license (BSD-3-Clause).

  • Fix typo’s in docstrings.

  • Update Travis configuration.

  • Drop MANIFEST.in, use setuptools_scm.

  • Stop using _version.py, use git tags for versioning.

  • Fixed issues with labels and input (#174 and #181).

1.0.1 (2019-08-30)

  • Fix support for Python 3.5 (#168).

  • Set correct Python versions in setup.py.

  • Fix make test command.

1.0.0 (2019-08-30)

  • Set default class for buttons to btn-primary (#150.

  • Drop support for Python 2 and Django 1.11, 2.0 and 2.1 (#155).

  • Template tag bootstrap_field now allows 3 values for show_label: True, False, sr-only and skip\. In the case of False / sr-only the label is hidden but present for screen readers. When show_label is set to skip, the label is not generated at all.

  • Fix validation on input groups (#122).

  • No longer duplicate jquery in bootstrap4.html (#139, #140).

  • Apply form-check, form-check-label and form-check-input classes to appropriate tags for RadioSelect and CheckboxSelectMultiple widgets (#141).

  • Errors on file inputs are shown (#146).

  • Only display non-field errors in form alert block (#161).

  • Reinstate bootstrap4_title block to bootstrap4.html (#156).

  • Fix typo in alert-dismissible class (#142).

  • Honor the form_group_class parameter in the buttons tag (#162).

0.0.8 (2019-03-12)

  • Drop support for the base_url setting (#105).

  • Remove use of “falsy” as a string literal (#111).

  • Fix javascript inclusion bugs (#71).

  • Allow email to have addons (#131).

  • Do not mark placeholder text as safe (#135).

0.0.7 (2018-08-22)

  • Improve alert accessibility (#93.

  • Add a new widget: RadioSelectButtonGroup (#103.

  • Several fixes and improvements to HTML renderin.

  • Switch to explicit Travis test.

  • Upgrade Bootstrap to 4.1.1

  • Upgrade jQuery to 3.3.1

  • Upgrade Popper to 1.14.3

  • Fixed bootstrap4.html to add jQuery per setting include_jquery=[False|'full'|'slim'].

  • Adopt Black formatting, see https://github.com/ambv/black.

0.0.6 (2018-02-14)

  • Change form help text element from div to small (#60).

  • Upgrade Bootstrap to 4.0.0 (#66).

0.0.5 (2018-01-03)

  • Drop develop branch, work with master and feature branches.

  • Clean up HISTORY.rst.

  • Upgrade Bootstrap to 4.0.0-beta.3.

  • Use col-4 rather than col-xs-4 (#54).

  • Added pagination alignment options (#56).

  • Fixed form field errors and help texts (#39.

  • Use django language if USE_I18N=True (#53).

0.0.4 (2017-10-26)

  • Upgrade Bootstrap to 4.0.0-beta.2.

  • Fix settings, tags and tests for remote JS and CSS.

0.0.3 (2017-09-24)

  • Upgraded bootstrap4 to the beta version.

[0.0.2] - (2017-09-06, not released on PyPI)

  • Upgraded jQuery version from CDN to 3.2.1 (#17).

  • Added proper pagination layout classes (#19).

0.0.1 (2017-06-04)

  • First release.

  • Remove bootstrap_icon, BS4 no longer has default icons.

  • Various changes to get from 3 to 4, started MIGRATE.rst.

  • Started django-bootstrap4 based on django-bootstrap3.

  • Thanks everybody that contributed to django-bootstrap3!