NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #2524 most downloaded on PyPI
Django application and library for importing and exporting data with included admin integration.
Latest stable
4.4.5
Last release 6 days ago
09 Nov 2026
Release timing varies
gaps range from 2 weeks to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
14 years old
114 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
This release adds some deprecations which will be removed in a future release.
This release makes some minor changes to the public API. If you have overridden any methods from the resources or widgets modules, you may need to update your implementation to accommodate these changes.
This fixes an issue where ManyToMany fields are not checked correctly in skip_row(). This means that skip_row() now takes row as a mandatory arg. If you have overridden skip_row() in your own implementation, you will need to add row as an arg.
If you have overridden skip_row() you can choose whether or not to skip rows if validation errors are present. The default behavior is to not to skip rows if there are validation errors during import.
import_export.resources.save_instance() now takes an additional mandatory argument: is_create. If you have overridden save_instance() in your own code, you will need to add this new argument.
If you have overridden clean() then you should update your method definition to reflect this change.
widgets.ForeignKeyWidget / widgets.ManyToManyWidget: The unused *args param has been removed from __init__(). If you have overridden ForeignKeyWidget or ManyToManyWidget you may need to update your implementation to reflect this change.
Exceptions raised during the import process are now presented as form errors, instead of being wrapped in a <H1> tag in the response. If you have any custom logic which uses the error written directly into the response, then this may need to be changed.
Previous ImportForm implementation was based on Django's forms.Form, if you have any custom ImportForm you now need to inherit from import_export.forms.ImportExportFormBase.
If you are using admin mixins from this library in conjunction with code that overrides change_list_template (typically admin mixins from other libraries such as django-admin-sortable2 or reversion), object tools in the admin change list views may render differently now.
If you have created a custom template which extends any import_export template, then this may now cause a recursion error (see `1415 <https://github.com/django-import-export/django-import-export/pull/1415 >`_)
If you have made customizations to the import template then you may need to refactor these after the addition of block declarations.
This release adds some deprecations which will be removed in a future release.
Add support for multiple resources in ModelAdmin. (1223)
The *Mixin.resource_class accepting single resource has been deprecated and the new *Mixin.resource_classes accepting subscriptable type (list, tuple, ...) has been added.
Same applies to all of the get_resource_class, get_import_resource_class and get_export_resource_class methods.
Deprecated exceptions.py (1372)
Refactored form-related methods on ImportMixin / ExportMixin (1147)
The following are deprecated:
get_import_form()
get_confirm_import_form()
get_form_kwargs()
get_export_form()
Default format selections set correctly for export action (1389)
Added option to store raw row values in each row's RowResult (1393)
Add natural key support to ForeignKeyWidget (1371)
Optimised default instantiation of CharWidget (1414)
Allow custom change_list_template in admin views using mixins (1483)
Added blocks to import template (1488)
improve compatibility with previous ImportForm signature (1434)
Refactored form-related methods on ImportMixin / ExportMixin (1147)
Include custom form media in templates (1038)
Remove unnecessary files generated when running tox locally (1426)
Fixed Makefile coverage: added coverage combine
Fixed handling of LF character when using CacheStorage (1417)
bugfix: skip_row() handles M2M field when UUID pk used
Fix broken link to tablib formats page (1418)
Fix broken image ref in README.rst
bugfix: skip_row() fix crash when model has m2m field and none is provided in upload (1439)
Fix deprecation in example application: Added support for transitional form renderer (1451)
Increased test coverage, refactored CI build to use tox (1372)
Clarified issues around the usage of temporary storage (1306)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix deprecation in example application: Added support for transitional form renderer (1451 _)
Updated import.css to support dark mode (1318 _)
Updated import.css to support dark mode (1318)
Fix crash when import_data() called with empty Dataset and collect_failed_rows=True (1381)
Improve Korean translation (1402)
Update example subclass widget code (1407)
Drop support for python3.6, django 2.2, 3.0, 3.1 (1408)
Add get_export_form() to ExportMixin (1409)
Removed django_extensions from example app settings (1356 _)
Big integer support for Integer widget (788 _)
Big integer support for Integer widget (788)
Run compilemessages command to keep .mo files in sync (1299)
Added skip_html_diff meta attribute (1329)
Added python3.10 to tox and CI environment list (1336)
Add ability to rollback the import on validation error (1339)
Fix missing migration on example app (1346)
Fix crash when deleting via admin site (1347)
Use Github secret in CI script instead of hard-coded password (1348)
Documentation: correct error in example application which leads to crash (1353)
Revert 'dark mode' css: causes issues in django2.2 (1330 _)
Revert 'dark mode' css: causes issues in django2.2 (1330)
Added guard for null 'options' to fix crash (1325 _)
Added guard for null 'options' to fix crash (1325)
Updated import.css to support dark mode (1323)
Fixed regression where overridden mixin methods are not called (1315)
Fix xls/xlsx import of Time fields (1314)
Added support for 'to_encoding' attribute (1311)
Removed travis and replaced with github actions for CI (1307)
Increased test coverage (1286)
Fix minor date formatting issue for date with years < 1000 (1285)
Translate the zh_Hans missing part (1279)
Remove code duplication from mixins.py and admin.py (1277)
Fix example in BooleanWidget docs (1276)
Better support for Django main (1272)
don't test Django main branch with python36,37 (1269)
Support Django 3.2 (1265)
Correct typo in Readme (1258)
Rephrase logical clauses in docstrings (1255)
Support multiple databases (1254)
Update django master to django main (1251)
Add Farsi translated messages in the locale (1249)
Update Russian translations (1244)
Append export admin action using ModelAdmin.get_actions (1241)
Fix minor mistake in makemigrations command (1233)
Remove EOL Python 3.5 from CI (1228)
CachedInstanceLoader defaults to empty when import_id is missing (1225)
Add kwargs to import_row, import_object and import_field (1190)
Call load_workbook() with data_only flag (1095)
Changed the default value for IMPORT_EXPORT_CHUNK_SIZE to 100. (1196 _)
Fix deprecated Django 3.1 Signal(providing_args=...) usage.
Fix deprecated Django 3.1 Signal(providing_args=...) usage.
Fix deprecated Django 3.1 django.conf.urls.url() usage.
Add missing translation keys for all languages (1144 _)
Deal with importing a BooleanField that actually has True, False, and None values. (1071 _)
Fix DurationWidget handling of zero value (1117 _)
Fix DurationWidget handling of zero value (1117)
Make import diff view only show headers for user visible fields (1109)
Make confirm_form accessible in get_import_resource_kwargs and get_import_data_kwargs (994, 1108)
Initialize Decimal with text value, fix #1035 (1039)
Adds meta flag 'skip_diff' to enable skipping of diff operations (1045)
Add support for tablib >= 1.0 (1061 _)
Fix deprecated Django 3.0 function usage (1054 _)
Removed support for Django < 2.0
Removed support for Django < 2.0
Removed support for Python < 3.5
feat: Support for Postgres JSONb Field (904)
Removed support for Django < 2.0
Removed support for Python < 3.5
feat: Support for Postgres JSONb Field ( 904 )
feat: Better surfacing of validation errors in UI / optional model instance validation (852 _)
fix: Django2.1 ImportExportModelAdmin export (797 _, 819 _)
setup: add django2.1 to test matrix
JSONWidget for jsonb fields (803)
Add ExportActionMixin (809)
Add Import Export Permissioning #608 (804)
write_to_tmp_storage() for import_action() (781)
follow relationships on ForeignKeyWidget (798)
Update all pypi.python.org URLs to pypi.org
added test for tsv import
added unicode support for TSV for python 2
Added ExportViewMixin (692)
fix: warning U mode is deprecated in python 3 (776 _)
Make deep copy of fields from class attr to instance attr (550)
Fix #612: NumberWidget.is_empty() should strip the value if string type (613)
Fix #713: last day isn't included in results qs (779)
use Python3 compatible MySql driver in development (706)
fix: warning U mode is deprecated in python 3 (776)
refactor: easier overriding widgets and default field (769)
Updated documentation regarding declaring fields (735)
custom js for action form also handles grappelli (719)
Use 'verbose_name' in breadcrumbs to match Django default (732)
Add Resource.get_diff_class() (745)
Fix and add polish translation (747)
Restore raise_errors to before_import (749)
Switch to semver versioning (687 _)
skip_row override example (702 _)
Refactor import_row call by using keyword arguments (585 _)
Refactor import_row call by using keyword arguments (585)
Added {{ block.super }} call in block bodyclass in admin/base_site.html (582)
Add support for the Django DurationField with DurationWidget (575)
GitHub bmihelac -> django-import-export Account Update (574)
Add intersphinx links to documentation (572)
Add Resource.get_import_fields() (569)
Fixed readme mistake (568)
Bugfix/fix m2m widget clean (515)
Allow injection of context data for template rendered by import_action() and export_action() (544)
Bugfix/fix exception in generate_log_entries() (543)
Process import dataset and result in separate methods (542)
Bugfix/fix error in converting exceptions to strings (526)
Fix admin integration tests for the new "Import finished..." message, update Czech translations to 100% coverage. (596)
Make import form type easier to override (604)
Add saves_null_values attribute to Field to control whether null values are saved on the object (611)
Add Bulgarian translations (656)
Add django 1.11 to TravisCI (621)
Make Signals code example format correctly in documentation (553)
Add Django as requirement to setup.py (634)
Update import of reverse for django 2.x (620)
Add Django-version classifiers to setup.py’s CLASSIFIERS (616)
Some fixes for Django 2.0 (672)
Strip whitespace when looking up ManyToMany fields (668)
Fix all ResourceWarnings during tests in Python 3.x (637)
Remove downloads count badge from README since shields.io no longer supports it for PyPi (677)
Add coveralls support and README badge (678)
French locale not in pypi (524 _)
Hide default value in diff when importing a new instance (458 _)
Hide default value in diff when importing a new instance (458)
Append rows to Result object via function call to allow overriding (462)
Add get_resource_kwargs to allow passing request to resource (457)
Expose Django user to get_export_data() and export() (447)
Add before_export and after_export hooks (449)
fire events post_import, post_export events (440)
add **kwargs to export_data / create_dataset
Add before_import_row() and after_import_row() (452)
Add get_export_fields() to Resource to control what fields are exported (461)
Control user-visible fields (466)
Fix diff for models using ManyRelatedManager
Handle already cleaned objects (484)
Add after_import_instance hook (489)
Use optimized xlsx reader (482)
Adds resource_class of BookResource (re-adds) in admin docs (481)
Require POST method for process_import() (478)
Add SimpleArrayWidget to support use of django.contrib.postgres.fields.ArrayField (472)
Add new Diff class (477)
Fix #375: add row to widget.clean(), obj to widget.render() (479)
Restore transactions for data import (480)
Refactor the import-export templates (496)
Update doc links to the stable version, update rtfd to .io (507)
Fixed typo in the Czech translation (495)
Add FloatWidget, use with model fields models.FloatField (433 _)
FIX: No static/ when installed via pip (427 _)
FIX: No static/ when installed via pip (427)
Add total # of imports and total # of updates to import success msg
fix MediaStorage does not respect the read_mode parameter (416 _)
- add xlsx import support
add xlsx import support
fix for fields with a dyanmic default callable (360 _)
fix for fields with a dyanmic default callable (360)
Django 1.4 is not supported (348 _)
Add Django 1.9 support
Django 1.4 is not supported (348)
- FIX: importing csv in python 3
FIX: importing csv in python 3
FIX: importing csv UnicodeEncodeError introduced in 0.2.9 (347 _)
FIX: importing csv UnicodeEncodeError introduced in 0.2.9 (347)
Allow Field.save() relation following (344 _)
use the IntegerWidget for database-fields of type BigIntegerField (302 _)
add attribute inheritance to Resource (140 _)
Try to use OrderedDict instead of SortedDict, which is deprecated in Django 1.7 (157 _)
Do not convert numeric types to string (149 _)
FIX: Properly handle NullBoleanField (115 _) - Backward Incompatible Change previously None values were handled as false
fix: get_value raised attribute error on model method call
Fixed XLS import on python 3. Optimized loop
Fixed properly skipping row marked as skipped when importing data from the admin interface.
Allow Resource.export to accept iterables as well as querysets
Improve error messages
FIX: Properly handle NullBoleanField (115) - Backward Incompatible Change previously None values were handled as false
Add separator and field keyword arguments to ManyToManyWidget
Add separator and field keyword arguments to ManyToManyWidget
FIX: No support for dates before 1900 (93)
RowResult now stores exception object rather than it's repr
RowResult now stores exception object rather than it's repr
Admin integration - add EntryLog object for each added/updated/deleted instance
FIX import_file_name form field can be use to access the filesystem (65 _)
FIX import_file_name form field can be use to access the filesystem (65)
- Python 3 support
Python 3 support
Additional hooks for customizing the workflow (61 _)
Additional hooks for customizing the workflow (61)
Prevent queryset caching when exporting (44 _)
Use field_name instead of column_name for field dehydration, FIX (36 _)
DB transactions support for importing data
Fix packaging
DB transactions support for importing data
support for deleting objects during import
support for deleting objects during import
bug fixes
Allowing a field to be 'dehydrated' with a custom method
added documentation
added ExportForm to admin integration for choosing export file format
added ExportForm to admin integration for choosing export file format
refactor admin integration to allow better handling of specific formats supported features and better handling of reading text files
include all available formats in Admin integration
bugfixes
* Refactor api
Refactor api
One column per quarter.