Warning
If upgrading from v3, v4 introduces breaking changes. Please refer to release notes.
4.3.9 (2025-07-21)Allow specifying meta options in the model_resourcefactory (2078)
Allow custom fields and methods in model_resourcefactory (2081)
FAQ update to describe how to customize Excel exports (2088)
ui: fix error display twice issue on export field select page (2066)
ui: add ‘select all’ fields toggle on export page (2068)
Add Hebrew translation (2071)
ui: fix display of non field errors on import (2075)
Update French translation (2042)
Add flag to ignore empty rows in XLSX import (2028)
Add support for Django 5.2 (2037)
Fix Chinese translation (2040)
Handle QuerySets called with values() on export (2011)
Update all translations (2014)
Fix imports for openpyxl (2005)
Addition of import & export management commands (1992)
Handle IllegalCharacterError in xlsx exports (2001)
Add __repr__ method to InvalidRow for improved debugging (2003)
Removed dependency files in favour of pyproject.toml (1982)
Documentation updates (1989)
Fix crash on export of tz-aware datetime to binary formats (1995)
This release contains breaking changes. Please refer to release notes.
Upgraded tablib version (1627)
Document overriding formats (1868)
Consistent queryset creation in ModelAdmin export mixin (1890)
Deprecated get_valid_export_item_pks() in favour of get_queryset() (1890)
Improve deprecation warning for ExportViewFormMixin to report at point of class definition (1900)
Fix export for fields with custom declared name (1903)
Hide the “Resource” form when it only has one option (1908)
Update date, time and datetime widget render method to handle derived instance (1918)
Add support for Django 5.1 (1926)
Accept numbers using the numeric separators of the current language in number widgets (FloatWidget(), IntegerWidget(), DecimalWidget()) (1927)
Added warning for declared fields excluded from fields whitelist (1930)
Fix v3 regression: handle native types on export to spreadsheet (1939)
Fix export button displayed on change screen when export permission not assigned (1942)
Fix crash for Django 5.1 when rows are skipped (1944)
Allow callable in dehydrate method (1950)
Fix crash when Resource fields declared incorrectly (1963)
Updated dependencies (1979)
Restore return value for deprecated method get_fields() (1897)
Improve Error class (1882)
Fix response content assertions (1883)
Admin UI: display checkboxes before labels in export form (1884)
deprecated unused method: get_fields() (1885)
remove django version check for custom storages (1889)
docs: clarify for_delete() documentation (1877)
fix default Field returns empty string instead of ‘None’ (1872)
revert setting default value for attribute (1875)
fix documentation to show correct method for reading form data on export (1859)
Admin UI: display both field name and column name on export (1857)
fix export declared field with custom column name (1861)
fix declared fields do not have correct Widget class set (1861)
docs: clarify changes to CharWidget in v4 (1862)
refactor Resource to remove code duplication in export (1863)
Added additional test for export field order (1848)
fix crash on import when relation has custom PK (1853)
fix crash on export from action when instance has custom PK (1854)
Fix for invalid build due to malformed README.rst (1851)
Refactored DateWidget & DateTimeWidget to remove code duplication (1839)
Release note documentation updated (1840)
Added missing migration to example app (1843)
Fix admin UI display of field import order (1849)
Support widgets with CSS and JS media in ImportForm (1807)
Documentation updates (1833)
Clarified documentation when importing with import_id_fields (1836)
re-add resource_class deprecation warning (1837)
fixed Arabic translation for ‘import’ word (1838)
fix export with custom column name (1821)
fix allow column_name to be declared in fields list (1822)
fix clash between key_is_id and use_natural_foreign_keys (1824)
remove unreachable code (1825)
fix issue with widget assignment for custom ForeignKey subclasses (1826)
performance: select of valid pks for export restricted to action exports (1827)
fix crash on export with custom column name (1828)
remove outdated datetime formatting logic (1830)
fix crash on export when model has no id (1802)
fix Widget crash when django Field subclass is used (1805)
fix regression: allow imports when default import_id_field is not present (1813)
Refactor ordering logic (1626)
Refactor ‘diff’ logic to avoid calling dehydrate methods
Refactor declarations of fields, import_order and export_order to fix ordering issues
refactor to export HTML / formulae escaping updates (1638)
removed unused variable Result.new_record (1640)
Refactor resources.py to standardise method args (1641)
added specific check for missing import_id_fields (1645)
Enable optional tablib dependencies (1647)
added get_lookup_kwargs() to make it easier to override object lookup (1651)
Fix declaring existing model field(s) in ModelResource altering export order (1663)
Added do_instance_save() helper method (1668)
Enable defining Resource model as a string (1669)
Support multiple Resources for export (1671)
Support export from model change form (1687)
Import form defaults to read-only field if only one format defined (1690)
Updated Admin UI to track deleted and skipped Imports (1691)
Added customizable MediaStorage (1708)
Added customization of Admin UI import error messages (1727)
Improve output of error messages (1729)
Added feature: selectable fields for admin export view (1734)
Added specific check for declared import_id_fields not in dataset (1735)
added try / catch to add_instance_info() to handle unserializable instances (1767)
Add form error if source file contains invalid header (1780)
Remove unneeded format method overrides (1785)
Support dynamic selection of Resource class based on request property (1787)
dynamic widget parameters for CharField fixes ‘NOT NULL constraint’ error in xlsx (1485)
fix cooperation with adminsortable2 (1633)
Removed unused method utils.original()
Fix deprecated log_action method (1673)
fix multiple inheritance not setting options (1696)
Fix issue where declared Resource fields not defined in fields are still imported (1702)
Fixed handling of FieldError during Admin import (1755)
Fixed handling of django FieldError during Admin export (1756)
fix: YAML export does not work with SafeString (1762)
fix: render() crashes if value is None (1771)
fix form not being passed to get_import_resource_kwargs() (1789)
Fix: Missing default widget for PositiveBigIntegerField (1795)
Refactor build process (1630)
Refactored test_admin_integration(): split into smaller test modules (1662)
Refactored test_resources(): split into smaller test modules (1672)
Updated docker-compose command with latest version syntax in runtests.sh (1686)
Refactored resources into separate modules for declarative and options (1695)
Refactored tests to remove dependencies between tests (1703)
Handle python3.12 datetime deprecations (1705)
Refactor test_resources.py into smaller modules (1733)
Updated test coverage to include error row when collect_failed_rows is True (1753)
Removed support for django 3.2 (1790)
Added test for widgets generating by model fields 1795)
Clarified skip_diff documentation (1655)
Improved documentation relating to validation on import (1665)
Added FAQ entry for exporting large datasets (1706)
Relocated admin integration section from advanced_usage.rst into new file (1713)
Updated Admin integration documentation to clarify how to save custom form values (1746)
Fix slow export with ForeignKey id (1717)
updated translations for release-4 (1775)
Update translations for Russian language (1797)
Add additional django template block for extending import page (1776)
Pass get_export_resource_kwargs() to Resource constructor export_action() (1739)
Fix issue with model class passed to Resource constructor crashing on export (1745)
Fix indentation for skip_row docstring (1743)
Return kwargs by default from get_resource_kwargs() (1748)
Fix issue with highlight when using ‘light’ color scheme (1728)
Remove unnecessary ChangeList queries to speed up export via Admin UI (1715)
Respect color scheme override (1720)
Update FAQ to cover skipping rows with validation errors (1721)
Added support for django5 (1634)
Show list of exported fields in Admin UI (1685)
Added CONTRIBUTING.md
Added support for python 3.12 (1698)
Update Finnish translations (1701)
export_admin_action() can be overridden by subclassing it in the ModelAdmin (1681)
Updated Spanish translations (1639)
Added documentation and tests for retrieving instance information after import (1643)
render() returns None as empty string if coerce_to_string is True (1650)
Updated documentation to describe how to select for export in Admin UI (1670)
Added catch for django5 deprecation warning (1676)
Updated and compiled message files (1678)
Added .readthedocs.yaml (1625)
Remove ‘escape output’ deprecation (1618)
Removal of deprecated IMPORT_EXPORT_ESCAPE_OUTPUT_ON_EXPORT.
Deprecation of IMPORT_EXPORT_ESCAPE_HTML_ON_EXPORT. Refer to installation docs.
Refactoring and fix to support filtering exports (1579)
Add customizable blocks in import.html (1598)
Include ‘allowed formats’ settings (1606)
Add kwargs to enable CharWidget to return values as strings (1623)
Add Finnish translation (1588)
Updated ru translation (1604)
Fixed badly formatted translation string (1622)
Remove ‘escape output’ deprecation (1618)
Added support for Django 4.2 (1570)
Add automatic formatting and linting (1571)
removed duplicate admin integration tests (1616)
Removed support for python3.7 and django4.0 (past EOL) (1618)
Updated documentation for interoperability with third party libraries (1614)
Escape formulae on export to XLSX (1568)
This includes deprecation of IMPORT_EXPORT_ESCAPE_OUTPUT_ON_EXPORT.
Refer to installation for alternatives.
import_export.formats.TablibFormat.export(): escape_output flag now deprecated in favour of escape_html and escape_formulae.
Refactor methods so that args are declared correctly (1566)
This includes deprecations to be aware of if you have overridden export() or ImportExportFormBase.
export(): If passing queryset as the first arg, ensure this is passed as a named parameter.
ImportExportFormBase: If passing resources to __init__ as the first arg, ensure this is passed as a named parameter.
Updated setup.py (1564)
Added SECURITY.md (1563)
Updated FAQ to include workaround for RelatedObjectDoesNotExist exception (1562)
Prevent error comparing m2m field of the new objects (1560)
Add documentation for passing data from admin form to Resource (1555)
Added new translations to Spanish and Spanish (Argentina) (1552)
Pass kwargs to import_set function (1448)
Float and Decimal widgets use LANGUAGE_CODE on export (1501)
Add optional dehydrate method param (1536)
exceptions module has been undeprecated
Updated DE translation (1537)
Add option for single step import via Admin Site (1540)
Add support for m2m add (1545)
collect errors on bulk operations (1541)
this change causes bulk import errors to be logged at DEBUG level not EXCEPTION.
Improve bulk import performance (1539)
raise_errors has been deprecated as a kwarg in import_row()
Reduce memory footprint during import (1542)
documentation updates (1533)
add detailed format parameter docstrings to DateWidget and TimeWidget (1532)
tox updates (1534)
fix xss vulnerability in html export (1546)
Support Python 3.11 (1508)
use get_list_select_related in ExportMixin (1511)
bugfix: handle crash on start-up when change_list_template is a property (1523)
bugfix: include instance info in row result when row is skipped (1526)
bugfix: add **kwargs param to Resource constructor (1527)
Updated django-import-export-ci.yml to fix node.js deprecation
bugfix: DateTimeWidget.clean() handles tz aware datetime (1499)
Updated translations for v3.0.0 release (1500)
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.
ManyToManyField in skip_row() (1271)
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.
skip_unchanged is set (1378)
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.
widgets: Unused *args params have been removed from method definitions. (1413)
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.
change_list_template in admin views using mixins (1483)
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 >`_)
import.html: Added blocks to import template (1488)
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_classaccepting single resource has been deprecated and the new*Mixin.resource_classesaccepting subscriptable type (list, tuple, …) has been added.Same applies to all of the
get_resource_class,get_import_resource_classandget_export_resource_classmethods.
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)
Fix deprecation in example application: Added support for transitional form renderer (1451)
Escape HTML output when rendering decoding errors (1469)
Apply make_aware when the original file contains actual datetimes (1478)
Automatically guess the format of the file when importing (1460)
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)
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)
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)
Add translation for Korean (1218)
Update linting, CI, and docs.
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)
Added missing Portuguese translations (1145)
Add kazakh translations (1161)
Add bulk operations (1149)
Deal with importing a BooleanField that actually has True, False, and None values. (1071)
Add row_number parameter to before_import_row, after_import_row and after_import_instance (1040)
Paginate queryset if Queryset.prefetch_related is used (1050)
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)
Add ability to install a subset of tablib supported formats and save some automatic dependency installations (needs tablib >= 1.0)
Use column_name when checking row for fields (1056)
Fix deprecated Django 3.0 function usage (1054)
Pin tablib version to not use new major version (1063)
Format field is always shown on Django 2.2 (1007)
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)
chore: Use modern setuptools in setup.py (862)
chore: remove outdated workarounds
chore: Run SQLite tests with in-memory database
fix: Change logging level (832)
fix: Changed get_instance() return val (842)
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)
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)
skip_row override example (702)
Testing against Django 2.0 should not fail (709)
Refactor transaction handling (690)
Resolves #703 fields shadowed (703)
discourage installation as a zipped egg (548)
Fixed middleware settings in test app for Django 2.x (696)
Refactors and optimizations (686, 632, 684, 636, 631, 629, 635, 683)
Travis tests for Django 2.0.x (691)
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)
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 default values in fields (431, 364)
Field constructor default argument is NOT_PROVIDED instead of None Field clean method checks value against Field.empty_values [None, ‘’]
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)
Reset SQL sequences when new objects are imported (59)
Let Resource rollback if import throws exception (377)
Fixes error when a single value is stored in m2m relation field (177)
Add support for django.db.models.TimeField (381)
add xlsx import support
fix for fields with a dyanmic default callable (360)
Add Django 1.9 support
Django 1.4 is not supported (348)
FIX: importing csv in python 3
FIX: importing csv UnicodeEncodeError introduced in 0.2.9 (347)
Allow Field.save() relation following (344)
Support default values on fields (and models) (345)
m2m widget: allow trailing comma (343)
Open csv files as text and not binary (127)
use the IntegerWidget for database-fields of type BigIntegerField (302)
make datetime timezone aware if USE_TZ is True (283).
Fix 0 is interpreted as None in number widgets (274)
better error reporting (259)
Django 1.8 compatibility
add attribute inheritance to Resource (140)
make the filename and user available to import_data (237)
Add to_encoding functionality (244)
Call before_import before creating the instance_loader - fixes (193)
added use of get_diff_headers method into import.html template (158)
Try to use OrderedDict instead of SortedDict, which is deprecated in Django 1.7 (157)
fixed #105 unicode import
remove invalid form action “form_url” (154)
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
FIX: No support for dates before 1900 (93)
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)
Python 3 support
Additional hooks for customizing the workflow (61)
Prevent queryset caching when exporting (44)
Allow unchanged rows to be skipped when importing (30)
Update tests for Django 1.6 (57)
Allow different ResourceClass to be used in ImportExportModelAdmin (49)
Use field_name instead of column_name for field dehydration, FIX (36)
Handle OneToOneField, FIX (17) - Exception when attempting access something on the related_name.
export filter not working (23)
Fix packaging
DB transactions support for importing data
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
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
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4