v2.0.0a0

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_.

Config variable name	What’s changed
FLASK_ADMIN_SWATCH	Removed; use Theme(swatch=...) instead
FLASK_ADMIN_FLUID_LAYOUT	Removed; use Theme(fluid=...) instead
MAPBOX_MAP_ID	Renamed to FLASK_ADMIN_MAPBOX_MAP_ID
MAPBOX_SEARCH	Renamed to FLASK_ADMIN_MAPBOX_SEARCH
MAPBOX_ACCESS_TOKEN	Renamed to FLASK_ADMIN_MAPBOX_ACCESS_TOKEN
GOOGLE_MAPS_API_KEY	Renamed to FLASK_ADMIN_GOOGLE_MAPS_API_KEY
DEFAULT_CENTER_LAT	Renamed to FLASK_ADMIN_DEFAULT_CENTER_LAT
DEFAULT_CENTER_LONG	Renamed to FLASK_ADMIN_DEFAULT_CENTER_LONG
ADMIN_RAISE_ON_INTEGRITY_ERROR	Renamed to FLASK_ADMIN_RAISE_ON_INTEGRITY_ERROR
ADMIN_RAISE_ON_VIEW_EXCEPTION	Renamed to FLASK_ADMIN_RAISE_ON_VIEW_EXCEPTION

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.

1.6.1

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

1.6.0

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

v1.5.8

• SQLAlchemy 1.4.5+ compatibility fixes
• Redis CLI fixes

v1.5.7

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

v1.5.6

• SQLAlchemy 1.3.6 compatibility fix
• Python 3.8 support

v1.5.5

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

1.5.4

• 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

v1.5.3

• 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

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