Django application and library for importing and exporting data with admin integration.
BSD-2-CLAUSE License
.. |build| image:: https://github.com/django-import-export/django-import-export/actions/workflows/release.yml/badge.svg :target: https://github.com/django-import-export/django-import-export/actions/workflows/release.yml :alt: Build status on Github
.. |coveralls| image:: https://coveralls.io/repos/github/django-import-export/django-import-export/badge.svg?branch=main :target: https://coveralls.io/github/django-import-export/django-import-export?branch=main
.. |pypi| image:: https://img.shields.io/pypi/v/django-import-export.svg :target: https://pypi.org/project/django-import-export/ :alt: Current version on PyPi
.. |docs| image:: http://readthedocs.org/projects/django-import-export/badge/?version=stable :target: https://django-import-export.readthedocs.io/en/stable/ :alt: Documentation
.. |pyver| image:: https://img.shields.io/pypi/pyversions/django-import-export :alt: PyPI - Python Version
.. |djangover| image:: https://img.shields.io/pypi/djversions/django-import-export :alt: PyPI - Django Version
.. |downloads| image:: https://static.pepy.tech/personalized-badge/django-import-export?period=month&units=international_system&left_color=black&right_color=blue&left_text=Downloads/month :target: https://pepy.tech/project/django-import-export
.. |xfollow| image:: https://img.shields.io/twitter/url/https/twitter.com/django_import.svg?style=social&label=Follow%20%40django_import :alt: Follow us on X :target: https://twitter.com/django_import
.. |discord| image:: https://img.shields.io/discord/1240294048653119508?style=flat :alt: Discord
|build| |coveralls| |pypi| |docs| |pyver| |djangover| |downloads| |xfollow| |discord|
Straightforward, reliable and comprehensive file import / export for your Django application.
django-import-export is an application and library which lets you manage import / export from / to a variety of sources (csv, xlsx, json etc).
Can be run programmatically, or with optional integration with the Django Admin site:
.. source of this video uploaded to this issue comment: https://github.com/django-import-export/django-import-export/pull/1833#issuecomment-2118777440
Screenshots <https://django-import-export.readthedocs.io/en/latest/screenshots.html>
_
Admin UI Integration <https://django-import-export.readthedocs.io/en/latest/admin_integration.html>
_ or programmatically <https://django-import-export.readthedocs.io/en/latest/getting_started.html#importing-data>
_tablib <https://github.com/jazzband/tablib>
_ supports)Preview <https://django-import-export.readthedocs.io/en/latest/screenshots.html/>
_ data before importing in Admin UIbulk import <https://django-import-export.readthedocs.io/en/latest/bulk_import.html>
_CRUD (and 'skip') operations during import <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#create-or-update-model-instances>
_foreign key <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#importing-model-relations>
_ relationshipsMany-to-many relationship <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#many-to-many-relations>
_ supportValidation <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#validation-during-import>
_ of imported datatransformations <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#advanced-data-manipulation-on-export>
_ for exported datadifferent views <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#customize-resource-options>
_natural keys <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#django-natural-keys>
__ for portability between environmentsSelect items for export <https://django-import-export.readthedocs.io/en/latest/screenshots.html/>
_ via the Admin UI object listSelect fields for export <https://django-import-export.readthedocs.io/en/latest/screenshots.html/>
_ via the export formExport single object instances <https://django-import-export.readthedocs.io/en/latest/admin_integration.html#export-from-model-instance-change-form>
_django permissions <https://django-import-export.readthedocs.io/en/latest/installation.html#import-export-import-permission-code>
_ to control import / export authorizationtablib <https://github.com/jazzband/tablib>
__add custom logic to control import / export <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html>
_Celery <https://django-import-export.readthedocs.io/en/latest/celery.html>
_ integrationDocker <https://django-import-export.readthedocs.io/en/latest/testing.html>
_documentation <https://django-import-export.readthedocs.io/en/latest/index.html>
__Extensible API <https://django-import-export.readthedocs.io/en/latest/api_admin.html>
_django-import-export is designed to be extensible and can be used to support a variety of operations. Here are some examples of how it has been used in the wild:
permissions <https://django-import-export.readthedocs.io/en/latest/installation.html#import-export-import-permission-code>
_ to define a subset of users able to import and export project datanatural keys <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#django-natural-keys>
_hooks <https://django-import-export.readthedocs.io/en/latest/advanced_usage.html#advanced-data-manipulation-on-export>
_ to anonymize data on exportModify import / export UI forms <https://django-import-export.readthedocs.io/en/latest/admin_integration.html#customize-admin-import-forms>
_ to add dynamic filtering on import / export.Installation <https://django-import-export.readthedocs.io/en/latest/installation.html>
_Getting started <https://django-import-export.readthedocs.io/en/latest/getting_started.html>
__Example application <https://django-import-export.readthedocs.io/en/latest/installation.html#exampleapp>
_Documentation <https://django-import-export.readthedocs.io/en/latest/>
_FAQ <https://django-import-export.readthedocs.io/en/latest/faq.html>
_Getting help <https://django-import-export.readthedocs.io/en/latest/faq.html#what-s-the-best-way-to-communicate-a-problem-question-or-suggestion>
_Contributing <https://django-import-export.readthedocs.io/en/latest/faq.html#how-can-i-help>
_sponsor <https://github.com/sponsors/django-import-export>
_Raise a security issue <https://github.com/django-import-export/django-import-export/blob/main/SECURITY.md>
_discord <https://discord.gg/aCcec52kY4>
_Commercial support is provided by Bellaport Systems Ltd <https://www.bellaport.co.uk>
_
Release notes <https://django-import-export.readthedocs.io/en/latest/release_notes.html>
_Changelog <https://django-import-export.readthedocs.io/en/latest/changelog.html>
_