Django import / export

django-import-export is a Django application and library for importing and exporting data with included admin integration.

Features:

• Import from / Export to multiple file formats
• Manage import / export of object relations, data types
• Handle create / update / delete / skip during imports
• Extensible API
• Support multiple formats (Excel, CSV, JSON, … and everything else that tablib supports)
• Bulk import
• Admin integration for importing / exporting
  • Preview import changes
  • Export data respecting admin filters

A screenshot of the change view with Import and Export buttons.

User Guide

• Installation and configuration
  • Settings
  • Example app
• Getting started
  • Introduction
  • Test data
  • The test models
  • Creating a resource
  • Importing data
  • Exporting data
• Advanced usage
  • Customize resource options
  • Field widgets
  • Importing model relations
  • Create or update model instances
  • Handling duplicate data
  • How to set a value on all imported instances prior to persisting
  • Advanced data manipulation on export
  • Signals
  • Admin integration
• Import data workflow
  • Transaction support
• Bulk imports
  • Caveats
  • Performance tuning
  • Testing
• Using celery to perform imports
• Testing
  • MySql / Postgres tests
  • Coverage
  • Bulk testing
• Frequently Asked Questions
  • What’s the best way to communicate a problem, question, or suggestion?
  • How can I help?
  • Common issues
• Changelog
  • 3.2.0 (2023-04-12)
  • 3.1.0 (2023-02-21)
  • 3.0.2 (2022-12-13)
  • 3.0.1 (2022-10-18)
  • 3.0.0 (2022-10-18)
  • 2.9.0 (2022-09-14)
  • 2.8.0 (2022-03-31)
  • 2.7.1 (2021-12-23)
  • 2.7.0 (2021-12-07)
  • 2.6.1 (2021-09-30)
  • 2.6.0 (2021-09-15)
  • 2.5.0 (2020-12-30)
  • 2.4.0 (2020-10-05)
  • 2.3.0 (2020-07-12)
  • 2.2.0 (2020-06-01)
  • 2.1.0 (2020-05-02)
  • 2.0.2 (2020-02-16)
  • 2.0.1 (2020-01-15)
  • 2.0 (2019-12-03)
  • 1.2.0 (2019-01-10)
  • 1.1.0 (2018-10-02)
  • 1.0.1 (2018-05-17)
  • 1.0.0 (2018-02-13)
  • 0.7.0 (2018-01-17)
  • 0.6.1 (2017-12-04)
  • 0.6.0 (2017-11-23)
  • 0.5.1 (2016-09-29)
  • 0.5.0 (2016-09-01)
  • 0.4.5 (2016-04-06)
  • 0.4.4 (2016-03-22)
  • 0.4.3 (2016-03-08)
  • 0.4.2 (2015-12-18)
  • 0.4.1 (2015-12-11)
  • 0.4.0 (2015-12-02)
  • 0.3.1 (2015-11-20)
  • 0.3 (2015-11-20)
  • 0.2.9 (2015-11-12)
  • 0.2.8 (2015-07-29)
  • 0.2.7 (2015-05-04)
  • 0.2.6 (2014-10-09)
  • 0.2.5 (2014-10-04)
  • 0.2.4 (2014-09-18)
  • 0.2.3 (2014-07-01)
  • 0.2.2 (2014-04-18)
  • 0.2.1 (2014-02-20)
  • 0.2.0 (2014-01-30)
  • 0.1.6 (2014-01-21)
  • 0.1.5 (2013-11-29)
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0

API documentation

• Admin
• Resources
  • Resource
  • ModelResource
  • ResourceOptions (Meta)
  • modelresource_factory
• Widgets
• Fields
• Instance loaders
• Temporary storages
  • TempFolderStorage
  • CacheStorage
  • MediaStorage
• Results
  • Result
• Forms

Developers

• Contributing
  • Philosophy
  • Questions
  • Guidelines For Reporting An Issue/Feature
  • Guidelines For Contributing Code