flask-admin v2.2.0 Release Notes

Release Date: 2026-05-07 // about 1 month ago
  • 🆕 New Features:

    • SQLAlchemy filter classes (FilterEqual, FilterLike, etc.) now accept a dotted-path string for the column argument (e.g. FilterEqual(column="author.email", name="Author Email")); the path is resolved against the view's model and the necessary joins are added automatically.

    🛠 Bugfixes:

    • 🛠 Fix a bug in v2.1.0 that caused UnboundLocalError in flask_admin.contrib.sqla.ModelView when an exception was raised during a create or update operation

Previous changes from v2.1.0

  • 2.1.0

    🗄 Deprecations:

    • 🗄 Deprecate ModelView(Model, db.session) in favor of ModelView(Model, db): #2717

    🆕 New Features:

    • 👍 Flask-SQLAlchemy-Lite support: #2789
    • ➕ Add page title header with icon above every view via new {% block page_title %}: #2706
    • ⬆️ Upgrade bundled Bootstrap from 4.2.1 to 4.6.2 and remove unminified files: #2787
    • Flash error message on form validation failure (“Failed to create/save record”): #2738

    🛠 Bugfixes:

    • 🛠 Fix CSS class on column headers (dots replaced with dashes e.g.: col-user.email → col-user-email): #2730
    • Return HTTP 403 instead of 500 when inaccessible_callback returns None: #2793
    • FileAdmin: show empty date instead of 1970-01-01 when directory has no timestamp: #2721
    • 🛠 Fix “Save & Add Another” using non-relative redirect URL (broke behind reverse proxies): #2716

    Others:

    • 👌 Improved examples, tests, type hints