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

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

• Adds support for Python 3.14: #2685
• Adds a MenuDivider item for bootstrap themes: #2696
• Field errors are now shown in red text for bootstrap themes: #2699

• Fix documentation
• Update arabic translations

Breaking changes from v1.6.1:

• Removed support for Python <3.10
• Use of the boto library has been replaced by boto3. S3FileAdmin and S3Storage now accept an s3_client parameter taking a boto3.client('s3') instance rather than aws_access_key_id, aws_secret_access_key, and region parameters.
• Azure Blob Storage SDK has been upgraded from the legacy version (v2) to the latest version (v12). AzureFileAdmin now accept blob_service_client rather than connection_string to give more flexibility with connection types.
• Flask-BabelEx is no longer supported; the package is no longer maintained and Flask-Babel is recommended/active instead.
• Mongoengine support in Flask-Admin no longer uses Flask-Mongoengine, as that library is no longer actively maintained.
• Bootstrap2 and Bootstrap3 themes are no longer available.
• Admin() now takes a theme parameter that encapsulates all of the configuration options for theming the admin instance. This replaces the template_mode parameter.
• All remaining Flask-Admin config has been namespaced under FLASK_ADMIN_.

New functionality:

• Added support for Python <=3.13
• The default query for pymongo can be overridden
• Flask async routes are supported
• Flask-Admin now supports the host_matching mode of Flask apps. See documentation for how to configure this where needed.
• Flask-Admin is now compatible with SQLAlchemy v2+, Flask v3+, WTForms v3+, and Pillow v10+.
• Flask-Admin now declares its dependencies and supported dependency versions more cleanly, including using pip extras. If you use Flask-Admin with SQLAlchemy, for example, you should use pip install flask-admin[sqlalchemy] or list flask-admin[sqlalchemy] in your requirements.txt or pyproject.toml files.
• Apps using content security policies to restrict the assets that can be loaded can now whitelist Flask-Admin's assets by passing a csp_nonce_generator function to the Admin instance. See examples or documentation for how to configure this where needed.
• page_size_options can now be configured on Admin models, to restrict the page sizes that users can select. These are now enforced properly and cannot be bypassed by URL hacking.

Fixes:

• Bootstrap menu icons should show up properly and not duplicated
• Redis CLI commands are now case insensitive
• SQLAlchemy boolean filters now convert "1" and "0" to Python booleans, which fixes a type coercion issue with psycopg(3).
• Jinja templates can now be loaded in StrictUndefined mode.
• Remove an implicit dependency on packaging
• Fixed an error caused by the fallback implementation of gettext() (when used in templates)
• Fixes compatibility with WTForms 3.2+.
• The Apply button for filters will show/hide correctly again
• Fix translations_path attribute when Flask-Admin is used with Flask-Babel
• Some translation updates.
• Date fields no longer override widget if set in form_args
• “Save and Continue Editing” button no longer discards the “return URL” (allowing to retain filters when switching back to the list)

Misc:

• Translations and docs have been updated
• Various type hinting improvements and fixes

• Serbian translation updates

Fixes:

• SQLAlchemy boolean filters now convert "1" and "0" to Python booleans, which fixes a type coercion issue with psycopg(3).

New functionality:

• Mongonengine support has been added back (no longer using flask-mongoengine): #2611
• The default query for pymongo can be overridden: #2661
• Flask async routes are supported: #2659

Fixes:

• Bootstrap menu icons should show up properly and not duplicated: #2666
• Redis CLI commands are now case insensitive: #2411

Misc:

• Translations and docs have been updated
• Various type hinting improvements and fixes

Breaking changes:

• Azure Blob Storage SDK has been upgraded from the legacy version (v2) to the latest version (v12). AzureFileAdmin now accept blob_service_client rather than connection_string to give more flexibility with connection types.

Fixes:

• Jinja templates can now be loaded in StrictUndefined mode.
• Remove an implicit dependency on packaging

2.0.0a2

Breaking changes:

• Removed support for Python 3.8.
• Use of the boto library has been replaced by boto3. S3FileAdmin and S3Storage now accept an s3_client parameter taking a boto3.client('s3') instance rather than aws_access_key_id, aws_secret_access_key, and region parameters.

2.0.0a1

Fixes:

• Fixes compatibility with WTForms 3.2+.
• The Apply button for filters will show/hide correctly again
• Fix translations_path attribute when Flask-Admin is used with Flask-Babel
• Some translation updates.
• Date fields no longer override widget if set in form_args
• “Save and Continue Editing” button no longer discards the “return URL” (allowing to retain filters when switching back to the list)

Changes from v1.x

Breaking changes:

• Added support for Python 3.12
• Dropped support for Python 3.7
• Flask-BabelEx is no longer supported; the package is no longer maintained and Flask-Babel is recommended/active instead.
• Flask-Mongoengine is no longer supported due to that package being unmaintained.
• Bootstrap2 and Bootstrap3 themes are no longer available.
• Admin() now takes a theme parameter that encapsulates all of the configuration options for theming the admin instance. This replaces the template_mode parameter.
• All remaining Flask-Admin config has been namespaced under FLASK_ADMIN_.

Title

New features:

• Flask-Admin now supports the host_matching mode of Flask apps. See documentation for how to configure this where needed.
• Flask-Admin is now compatible with SQLAlchemy v2+, Flask v3+, WTForms v3+, and Pillow v10+.
• Flask-Admin now declares its dependencies and supported dependency versions more cleanly, including using pip extras. If you use Flask-Admin with SQLAlchemy, for example, you should use pip install flask-admin[sqlalchemy] or list flask-admin[sqlalchemy] in your requirements.txt or pyproject.toml files.
• Apps using content security policies to restrict the assets that can be loaded can now whitelist Flask-Admin’s assets by passing a csp_nonce_generator function to the Admin instance. See examples or documentation for how to configure this where needed.
• page_size_options can now be configured on Admin models, to restrict the page sizes that users can select. These are now enforced properly and cannot be bypassed by URL hacking.

And various smaller bug fixes and documentation updates.

• SQLAlchemy 2.x support
• General updates and bug fixes
• Dropped WTForms 1 support

• Dropped Python 2 support
• WTForms 3.0 support
• Various fixes

• SQLAlchemy 1.4.5+ compatibility fixes
• Redis CLI fixes

• Bootstrap 4 support!
• Added hook for custom SQLAlchemy models initializers
• SQLAlchemy 1.4/2.0 compatibility fix

• SQLAlchemy 1.3.6 compatibility fix
• Python 3.8 support

• Werkzeug 1.0 compatibility fix
• Use fa-circle-o icon for unchecked booleans
• A few SQLAlchemy-related bug fixes

• Fix display of inline x-editable boolean fields on list view
• Add support for several SQLAlchemy-Utils data types
• Support searching on SQLAlchemy hybrid properties
• Extra URL paramaters are now propagated to the next page when searching / filtering
• Add enum34 dependency when running on legacy Python version
• Update Mapbox API v1 URL format
• Update jQuery and moment dependencies in templates
• Fixed a datepicker issue, where only dates up to 2015 were showing up
• Updated Pillow dependency version

• Fixed XSS vulnerability
• Support nested categories in the navbar menu
• SQLAlchemy
  • sort on multiple columns with column_default_sort
  • sort on related models in column_sortable_list
  • fix: inline model forms can now also be used for models with multiple primary keys
  • support for using mapped column_property
• Upgrade Leaflet and Leaflet.draw plugins, used for geoalchemy integration
• Specify minimum_input_length for ajax widget
• Peewee: support composite keys
• MongoEngine: when searching/filtering the input is now regarded as case-insensitive by default
• FileAdmin
  • handle special characters in filename
  • fix a bug with listing directories on Windows
  • avoid raising an exception when unknown sort parameter is encountered
• WTForms 3 support

1.5.2

• Fixed XSS vulnerability
• Fixed Peewee support
• Added detail view column formatters
• Updated Flask-Login example to work with the newer version of the library
• Various SQLAlchemy-related fixes
• Various Windows related fixes for the file admin

• Dropped Python 2.6 support

• Fixed SQLAlchemy >= 1.2 compatibility

• Fixed Pewee 3.0 compatibility

• Fixed max year for a combo date inline editor

• Lots of small bug fixes

• Fixed CSRF generation logic for multi-process deployments
• Added WTForms >= 3.0 support
• Flask-Admin would not recursively save inline models, allowing arbitrary nesting
• Added configuration properties that allow injection of additional CSS and JS dependencies into templates without overriding them
• SQLAlchemy backend
  • Updated hybrid property detection using new SQLAlchemy APIs
  • Added support for association proxies
  • Added support for remote hybrid properties filters
  • Added support for ARRAY column type
• Localization-related fixes
• MongoEngine backend is now properly formats model labels
• Improved Google App Engine support:
  • Added TextProperty, KeyProperty and SelectField support
  • Added support for form_args, excluded_columns, page_size and after_model_update
• Fixed URL generation with localized named filters
• FileAdmin has Bootstrap 2 support now
• Geoalchemy support fixes
  • Use Google Places (by default) for place search
• Updated translations
• Bug fixes

• Small bug fix release. Fixes regression that prevented usage of "virtual" columns with a custom formatter.

1.4.1

• Official Python 3.5 support
• Customizable row actions
• Tablib support (exporting to XLS, XLSX, CSV, etc)
• Updated external dependencies (jQuery, x-editable, etc)
• Added settings that allows exceptions to be raised on view errors
• Bug fixes

• Updated and reworked documentation
• FileAdmin went through minor refactoring and now supports remote file systems. Comes with the new, optional, AWS S3 file management interface
• Configurable CSV export for model views
• Added overridable URL generation logic. Allows using custom URLs with parameters for administrative views
• Added column_display_actions to ModelView control visibility of the action column without overriding the template
• Added support for the latest MongoEngine
• Added support for HSTORE columns to SQLA backend
• New SecureForm base class for easier CSRF validation
• Lots of translation-related fixes and updated translations
• Bug fixes

• New feature: Edit models in the list view in a popup
• New feature: Read-only model details view
• Fixed XSS in column_editable_list values
• Improved navigation consistency in model create and edit views
• Ability to choose page size in model list view
• Updated client-side dependencies (jQuery, Select2, etc)
• Updated documentation and examples
• Updated translations
• Bug fixes

• Codebase was migrated to Flask-Admin GitHub organization
• Automatically inject Flask-WTF CSRF token to internal Flask-Admin forms
• MapBox v4 support for GeoAlchemy
• Updated translations with help of CrowdIn
• Show warning if field was ignored in form rendering rules
• Simple AppEngine backend
• Optional support for Font Awesome in templates and menus
• Bug fixes

Mostly bug fix release. Highlights:

• Inline model editing on the list page
• FileAdmin refactoring and fixes
• FileUploadField and ImageUploadField will work with Required() validator
• Bug fixes