v2.0.0a2

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.

v2.0.0a1

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)

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