CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Verion 0.25.0 - 2026-04-18

Added

• Move to org by @aminalaee in #1018
• extra blocks for templates allowing customization by @birddevelper in #952
• Add template hooks to all filters for customizable UIs (dropdowns, sliders, etc.) by @fd-oncodna in #970
• Support MappedAsDataclass by @Goradii in #857
• save values types as is if possible while JSON export by @DenisDudnik in #865
• Add toast to notify results for custom actions by @rusanpas in #971
• Showing exceptions happened during delete in list page as per #898 by @mmzeynalli in #1022
• Quality of Life updates by @mmzeynalli in #1026
• [Feature] Check the available primary actions (edit, delete, view details) for each row on listing page. by @maxim-f1 in #874

Fixed

• Fix #841: Cannot update value of attribute with reserved name when it starts empty/null by @mmzeynalli in #1028
• Fix TypeError with UUID primary keys in issubclass check by @S3wnkin in #992
• core: fix ambiguous column error when searching or sorting by @nurikk in #983
• Handling SQLAlchemy UUID fields correctly by introducing new UuidField. by @mmzeynalli in #1023
• Fixes #915: Sorting exposed functions by their coded order not alphabetical by @mmzeynalli in #1024
• fix: add RootPathMiddleware for proper static file routing with root_… by @JartanFTW in #996

New Contributors

• @S3wnkin made their first contribution in #992
• @fd-oncodna made their first contribution in #970
• @Goradii made their first contribution in #857
• @nurikk made their first contribution in #983
• @DenisDudnik made their first contribution in #865
• @rusanpas made their first contribution in #971
• @JartanFTW made their first contribution in #996

Full Changelog: https://github.com/smithyhq/sqladmin/compare/0.24.0...0.25.0

Version 0.24.0 - 2026-03-30

Added

• Improve logout button and logo_url by @maxim-f1 in #995
• Support filtering Date and Datetime fields with "less than" and "greater than" operations. by @caarmen in #1010
• Added switch style for checkbox and fixed related bug. by @maxim-f1 in #975
• Add ModelView.search_auto_submit option for list search by @Airumian in #1003
• Add select_from to count query in models.py by @estyrke in #969

Fixed

• [Bug] Improved error display in the delete modal window by @maxim-f1 in #994
• [Bug] Authorization vulnerability for expose and action by @maxim-f1 in #993

New Contributors

• @caarmen made their first contribution in #1010
• @Airumian made their first contribution in #1003
• @estyrke made their first contribution in #969

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.23.0...0.24.0

Version 0.23.0 - 2026-02-04

Added

• Highlight applied filters with background and clear option by @danmysak in #964
• Implemented optional pretty CSV export by @TimofeiN in #938

Fixed

• fix: use children.extend in Menu.add by @wasinski in #892
• fix: Support set-based relationships in list/detail views by @msukmanowsky in #982
• Fixing an SQLAlchemy warning by @lorg in #980
• Fix buttons width on details page by @MaximDementyev in #978
• Migrate from hatchling to uv by @mmzeynalli in #974
• Change PK column name to title in list/detail page by @wnowicki in #977

New Contributors

• @danmysak made their first contribution in #964
• @TimofeiN made their first contribution in #938
• @wasinski made their first contribution in #892
• @msukmanowsky made their first contribution in #982
• @MaximDementyev made their first contribution in #978
• @mmzeynalli made their first contribution in #974

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.22.0...0.23.0

Version 0.22.0 - 2025-11-24

Added

• Implement OperationColumnFilter to filter String, Numeric, and UUID Types by @chezou in #945
• Support Python 3.14 by @aminalaee in #963

Fixed

• Fix filters inccorect records count by @birddevelper in #954

• docs - update the example ColumnFilter by @proby-actvo in #949

• Documentation improvements by @wnowicki in #941

• Fix date and time type handling when used as primary key by @twoodwark in #958

• Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.21.0...0.22.0

Version 0.21.0 - 2025-07-02

Added

• Add category_icon by @sheldygg in #848
• Add model convertors docs by @Vasiliy566 in #883
• Allow custom response in authentication logout by @joschnitzbauer in #914
• ModelView @expose decorator support by @foarsitter in #881
• Adding the ability to add filters to model views by @lorg in #906
• Details page query by @wray27 in #929
• export csv/json in utf-8 by @alserious in #911
• Indicate Required Fields with a Red Asterisk by @maxim-f1 in #880

Fixed

• Update hatch command in CONTRIBUTING.md by @foarsitter in #882
• fix: CategoryMenu is_active logic by @retromechs in #920
• Doc update - Related model name by @wnowicki in #917
• docs: Added model context, fixed syntax by @sreyemnayr in #930

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.20.1...0.21.0

Version 0.20.1 - 2024-10-28

Fixed

• Fix export json related model by @Vasiliy566 in #837
• Fix JSON export trailing comma by @jbrendel in #843

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.20.0...0.20.1

Version 0.20.0 - 2024-10-17

Added

• add json export format. by @Vasiliy566 in #829

Fixed

• clamp page if it exceeds the maximum page by @alex-lambdaloopers in #814

New Contributors

• @Vasiliy566 made their first contribution in #829

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.19.0...0.20.0

Version 0.19.0 - 2024-09-06

Added

• Add favicon by @sheldygg in #787
• Add tabler icons by @r-m-n in #795
• feat: use favicon_url instead of logo_url for favicon by @alex-lambdaloopers in #800
• Allow multiple ajax sorts and changes to result size by @mfriedy in #805

Fixed

• Fix column_property by @aminalaee in #791
• Fix page number issue when changing page size by @numberbee7070 in #782
• Document update to resolve DeprecationWarning from Starlette (#809) by @a4rcvv in #810
• Bug fix: unhandled exception during AjaxSelect load by @diskream in #727

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.18.0...0.19.0

Version 0.18.0 - 2024-07-01

Added

• Add form_rules, form_create_rules, form_edit_rules by @aminalaee in #779
• Add more docs for overriding default tempates by @jonocodes in #769

Fixed

• Fix edit_form_query documentation example by @lukeclimen in #777

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.17.0...0.18.0

Version 0.17.0 - 2024-05-13

Added

• Add field description to Create/Edit templates by @ngaranko in #722
• Add edit_form_query method by @lukeclimen in #745
• Validate page and pageSize query parameters by @BhuwanPandey in #752

Fixed

• Hide save and add another button from edit.html if can_create is False by @MaximZemskov in #742
• Fix list page sort symbol by @aminalaee in #744
• Move template files from templates to templates/sqladmin by @hasansezertasan in #748
• Fix form_args default by @aminalaee in #756
• Fix getting column python type by @aminalaee in #757
• Fix File and Image fields checkbox and input by @aminalaee in #761
• Switch relationship loading to selectionload by @aminalaee in #758
• Fix DELETE call query params by @aminalaee in #763

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.16.1...0.17.0

Version 0.16.1 - 2024-02-20

Fixed

• Re-add http_exception handler to Admin class in #694
• Move non-field-specific errors to top of edit and create forms in #707
• Fix sort by model attribute in #713
• Fix Category not respecting is_visible and is_accessible in #698

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.16.0...0.16.1

Version 0.16.0 - 2023-11-14

Added

• Switch to async templates by @aminalaee in #652
• Allow using related model fields in list/details page by @aminalaee in #653
• Allow sort by related model field by @aminalaee in #654
• Add search by related model field by @aminalaee in #655
• Expose request to model events by @holdmybeer1min in #660

Fixed

• Allow model columns to bear the same name as reserved wtforms.BaseForm attributes by @brouberol in #658
• Change pk converter in routes by @aminalaee in #666
• Fix multiple PK model containing boolean values by @ncarvajalc in #670
• Fix brand icon is not showing by @WiraDKP in #665

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.15.2...0.16.0

Version 0.15.1 - 2023-10-02

Fixed

• Avoid populating Select2 input with existing option by @Toshakins in #626
• Fix ItemMenu sort issue by @aminalaee in #631

Added

• Add customized sort query signature (#624) by @YarLikviD in #625

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.15.0...0.15.1

Version 0.15.0 - 2023-09-19

Breaking Changes

• Update AuthenticationBackend signature by @aminalaee in #581
• Change signature of list_query and count_query by @aminalaee in #610

Added

• Search in list when typing by @anton-petrov in #592
• Add category config by @aminalaee in #616
• Switch to HTML time input for Time field by @aminalaee in #595
• Add modal confirmation for bulk delete by @aminalaee in #612

Fixed

• Fix 'itsdangerous' import error when not using Authentication Backend by @GriceTurrble in #597
• Fix docs: Cookbook, Using a request object by @s1beria21 in #575
• Fix delete error no rows selected by @aminalaee in #591
• Fix typing of Admin session_maker by @sheldygg in #604
• Fix broken link in doc by @YannickLeRoux in #620

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.14.1...0.15.0

Version 0.14.1 - 2023-08-08

Fixed

• Fix Detail page to not use label to get value in #570

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.14.0...0.14.1

Version 0.14.0 - 2023-08-02

Added

• Pass request to model view methods by @rossmacarthur in #547
• Set sessionmaker on BaseAdmin by @rossmacarthur in #542
• Allow custom properties by @aminalaee in #544
• Change signature of delete_model by @aminalaee in #550
• Support SQLAlchemy sessionmaker in Admin by @aminalaee in #565

Fixed

• Fix expose and action Auth backend not called by @aminalaee in #561

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.13.0...0.14.0

Version 0.13.0 - 2023-06-30

Fixed

• Remove httpx from requirements by @agn-7 in #520
• Fix issue when search query contains special characters by @uriyyo in #523
• Fix Ajax UUID by @aminalaee in #525
• Fix search pagination by @aminalaee in #528
• Drop Python3.7 by @aminalaee in #530
• Fix Enum in detail page by @aminalaee in #531
• Add unique() to query related models by @florianabel in #535
• Add PosrgreSQL JSONB type support by @uriyyo in #533

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.12.0...0.13.0

Version 0.12.0 - 2023-06-13

Added

• Support sqlalchemy.sql.sqltypes.Uuid by @dexter-dopping-ekco in #501
• Implement multi pk support by @dexter-dopping-ekco in #507
• Support special __all__ keyword by @aminalaee in #511
• use @login_required for custom actions and views by @aminalaee in #513

Fixed

• Each ModelView can now have actions with the same name/slug by @murrple-1 in #503
• Fix count query in search page by @aminalaee in #506

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.11.0...0.12.0

Version 0.11.0 - 2023-05-23

Added

• Add ability to specify custom actions by @murrple-1 in #486
• Add ChoiceType by @aminalaee in #482
• Add sqlalchemy_fields URLType converter by @aminalaee in #493
• Upgrade fontawesome by @aminalaee in #481

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.10.3...0.11.0

Version 0.10.3 - 2023-04-21

Fixed

• Fix ImageType converter by @aminalaee in #471
• reset UploadFile seek after reading by @murrple-1 in #473
• Fix unnecessary joins in details and edit page by @aminalaee in #476

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.10.2...0.10.3

Version 0.10.2 - 2023-04-15

Fixed

• Fix nullable string fields by @aminalaee in #465
• Fix Multiselect field saving only one value by @nik-joseph in #463

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.10.1...0.10.2

Version 0.10.1 - 2023-03-25

Fixed

• Fix PK getters for related objects by @timoniq in #449

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.10.0...0.10.1

Version 0.10.0 - 2023-03-15

Breaking change

• Change AuthenticationBackend authenticate signature to support OAuth in #440

Added

• Add File field in #424
• Support SQLALchemy Interval type in #438

Fixed

• Fix docstrings by @linomp in #434
• Update to work with Starlette URL type in url_for by @aminalaee in #444
• Fix nullable Integers to accept zero value by @ovginkel in #445

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.9.0...0.10.0

Version 0.9.0 - 2023-02-07

Added

• Support SQLAlchemy v2 in #411
• Support PostgreSQL arrays in #414
• Add custom form converters in #399
• Support SQLAlchemy composite types in #421
• Add sqlalchemy_utils PhoneNumberType, ColorType and ArrowType in #422

Fixed

• Fix re-rendering create/edit page with existing data in #385
• Fix exclude columns breaking order in #407
• Fix control relationships in list page in #409
• Fix asyncpg BigInt query in #416

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.8.0...0.9.0

Version 0.8.0 - 2022-11-22

Added

• Add save_as option by @aminalaee in #377
• Add save_as_continue option by @aminalaee in #379
• Add extra Save buttons for Create/Edit page by @aminalaee in #373
• Display errors in alert for create/edit page by @aminalaee in #382

Fixed

• Fix _url_for methods ignoring root_path by @aminalaee in #371
• Fix export to use list_query option by @villqrd in #381

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.7.0...0.8.0

Version 0.7.0 - 2022-11-03

Added

• Add on_model_change and after_model_change methods by @dima23113 in #342
• Add on_model_delete and after_model_delete methods by @aminalaee in #343

Fixed

• Fix search by uuid column by @aminalaee in #366
• Update tests after starlette upgrade by @aminalaee in #344
• Remove hard-coded related model limit by @aminalaee in #354
• Improve items list UI by @ischaojie in #349
• Make navbar work on small screens by @aminalaee in #362

Internal

• Add mypy check with config no_implicit_optional by @ischaojie in #360
• Support test-suite py311 by @ischaojie in #365
• Add py.typed for the package to ship its typing information by @franciscorode in #346

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.6.1...0.7.0

Version 0.6.1 - 2022-09-25

Fixed

• Fix Boolean field for both nullable and non-nullable cases in #336
• Fix Flatpickr not respecting readonly inputs in #336
• Disable batch delete when can_delete permission is not provided in #335

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.6.0...0.6.1

Version 0.6.0 - 2022-09-19

Added

• Add bulk delete action by @aminalaee in #317

Fixed

• Handle null values when column is nullable by @aminalaee in #323
• Switch Boolean field to select field by @aminalaee in #321

Internal

• Fix form_ajax_refs example in documentation by @GitBib in #311
• Remove watch in mkdocstrings mkdocs's config by @ischaojie in #306

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.5.0...0.6.0

Version 0.5.0 - 2022-09-06

Added

• Add remote_ajax_refs in #292

Internal

• Avoid select query with ajax_form_refs in #300
• Add docs for form_ajax_refs in #302

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.4.0...0.5.0

Version 0.4.0 - 2022-08-31

Added

• Add Date and DateTime pickers using Fatpickr in #288
• Add Time picker using Flatpickr in #294

Internal

• Remove MomentJS in #289
• Remove Select2 widgets in #293

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.3.0...0.4.0

Version 0.3.0 - 2022-08-26

Added

• Add AuthenticationBackend in #277
• Update Authentication docs in #278

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.2.1...0.3.0

Version 0.2.1 - 2022-08-04

Fixed

• Fix middlewares and ENGINE_TYPE types in #266
• Fix middlewares not being applied in #267 and #271

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.2.0...0.2.1

Version 0.2.0 - 2022-08-01

Added

• Add list_query, count_query and search_query options in #243
• Add BaseView for custom pages in #244
• Add expose for BaseView in #251
• Rename ModelAdmin to ModelView in #249

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.12...0.2.0

Version 0.1.12 - 2022-07-13

Added

• Add time field converter by @ischaojie in #214
• Add Edit button for "Details" page by @cuamckuu in #222
• Add column_type_formatters by @aminalaee in #239

Fixed

• Fix lazy subuqery in list query by @aminalaee in #212
• Fix missing browser tab title by @cuamckuu in #229
• Remove sourceMappingURL in JS files by @aminalaee in #231

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.11...0.1.12

Version 0.1.11 - 2022-06-23

Added

• Add form_include_pk option by @aminalaee in #207

Fixed

• Fix handling of iterable fields by @okapies in #204
• Fix nullable Enum form by @aminalaee in #205

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.10...0.1.11

Version 0.1.10 - 2022-06-21

Added

• Add support for one-to-one relationship by @okapies in #182
• Add support for UUIDType from sqlalchemy_utils by @okapies in #183
• Add sqlalchemy_utils URL, Currency and Timezone by @aminalaee in #185
• Add form_widget_args by @aminalaee in #188
• Add column_default_sort by @aminalaee in #191

Fixed

• Fix link relationship to details page when null by @aminalaee in #174
• docs: fix typos by @pgrimaud in #161
• Allow QuerySelectField override object_list with form_args by @aminalaee in #171
• Fix form fields order when specifying columns by @okapies in #184
• Fix ModelConverter when impl is not callable by @aminalaee in #186

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.9...0.1.10

Version 0.1.9 - 2022-05-27

Added

• Add column_formatters by @skarrok in #140
• Add column_formatters_detail by @aminalaee in #141
• Handling for sqlalchemy_utils EmailType and IPAddressType by @colin99d in #150
• Link relationships to detail page by @aminalaee in #153

Fixed

• Function signature typing, and renames by @dwreeves in #116
• Fix SQLModel UUID type by @aminalaee in #158

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.8...0.1.9

Version 0.1.8 - 2022-04-19

Added

• Add csv export support by @dwreeves in #101
• Expose Starlette middlewares and debug to the Admin by @tr11 in #114

Fixed

• Fix Export unlimited rows by @aminalaee in #107
• Add form and export options docs by @aminalaee in #110
• fix docstring issues by adding an explicit handler by @dwreeves in #106
• Fix get_model_attr with column labels by @aminalaee in #128
• Delay call to self.get_converter to use form_overrides by @lovetoburnswhen in #129

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.7...0.1.8

Version 0.1.7 - 2022-03-22

Added

• Add SQLModel support by @aminalaee in #94
• Add form-specific functionality to ModelAdmin by @dwreeves in #97
• Add UUID field converter by @aminalaee in #82
• Add PostgreSQL INET and MACADDR converters by @aminalaee in #83

Fixed

• Fix Boolean field checkbox UI by @aminalaee in #88
• Fix PostgreSQL UUID PrimaryKey by @aminalaee in #92
• Fix Source Code Link by @baurt in #95

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.6...0.1.7

Version 0.1.6 - 2022-03-09

Added

• FontAwesome6 icons in #78
• Add column_sortable_list in #65
• Add JSON column converters in #74

Fixed

• Fix URL search regex in #67
• Fix Enum in Edit page in #71

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.5...0.1.6

Version 0.1.5 - 2022-02-24

Added

• Authentication in #37
• Add Edit view page in #60
• Add column_searchable_list in #61

Internal

• Cleanup DB queries in #51

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.4...0.1.5

Version 0.1.4 - 2022-02-16

Added

• Allow templates to be configured in #52
• Add page size option links in #34

Fixed

• Improve pagination in #36

Internal

• Instantiate ModelAdmin internally to avoid class methods in #31

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.3...0.1.4

Version 0.1.3 - 2022-01-24

Added

• Add title and logo options in #20
• Adding order_by to list pagination query in #25
• Allow Relationship properties in list and detail views in #22

Full Changelog: https://github.com/aminalaee/sqladmin/compare/0.1.2...0.1.3