How to Export Your Database in Django

When you're working on a Django project – whether it's a small side project or a growing web app – there comes a point where you need to export your database. Maybe you’re switching hosting providers. Maybe you're backing things up or sharing data wi...

Apr 21, 2025 - 20:22

When you're working on a Django project – whether it's a small side project or a growing web app – there comes a point where you need to export your database.

Maybe you’re switching hosting providers. Maybe you're backing things up or sharing data with someone. Or maybe you just want to peek at your data in a different format.

Exporting a database sounds technical (and yeah, it kind of is), but it doesn’t have to be hard. Django gives you built-in tools that make the process much easier than most people expect.

I’ve worked with Django for a while now, and I’ve helped developers, from beginners to pros, deal with database exports.

In this tutorial, I’m going to walk you through all the ways you can export your database in Django.

Here’s what we’ll cover:

Why Would You Want To Export Your Database?

There are a bunch of reasons you might want to export your Django database:

Backup: Before making big changes, it's smart to save a copy.
Migration: Moving to another server or switching from SQLite to PostgreSQL.
Sharing data: Giving a snapshot of the data to teammates or analysts.
Testing: Populating a test or staging environment with real data.
Compliance: Legal or policy reasons for storing data outside your app.

The good news? Django has solid tools to help you do all this quickly and cleanly.

First Things First: Know Your Database

Django supports several types of databases: SQLite (the default), PostgreSQL, MySQL, and more. Depending on what you’re using, your export process might look a little different.

But for most common cases, especially if you’re using SQLite or PostgreSQL, the methods I’m about to show you will work great.

Method 1: Use Django’s `dumpdata` Command

This is the easiest and most common way to export your data.

Step-by-step:

Open your terminal.
Navigate to your Django project folder.
Run the following command:

python manage.py dumpdata > db.json

That’s it. You’ve just exported all your data into a JSON file called db.json.

What’s happening here?

dumpdata is a Django management command that goes through your database and exports the data from all the models.
The > the symbol means "send the output into a file" instead of printing it on the screen.

Want to export just one app?

You can be more specific:

python manage.py dumpdata myapp > myapp_data.json

Or even one model:

python manage.py dumpdata myapp.MyModel > model_data.json

This is useful if your database is big and you only need a slice of it.

A Quick Tip About Fixtures

The file you just created (db.json) is called a fixture in Django. You can use it to load data into another project using:

python manage.py loaddata db.json

So yeah, dumpdata + loaddata is a super handy combo for moving data around.

Method 2: Use Your Database’s Tools

Depending on what database you're using, you can also use tools that work outside of Django.

For SQLite (Django’s default)

Your database is just a file, usually named db.sqlite3.

You can copy it like any other file:

cp db.sqlite3 db_backup.sqlite3

If you want to export the data as SQL statements, you can use the sqlite3 command-line tool:

sqlite3 db.sqlite3 .dump > db_dump.sql

This creates a file with all the SQL commands needed to recreate your database. Pretty handy for backups.

For PostgreSQL

You’ll need access to pg_dump, which is PostgreSQL's built-in export tool.

Here’s an example:

pg_dump -U your_username your_database > backup.sql

You might need to enter your password, depending on how your database is set up.

You can find more info on pg_dump here.

Method 3: Export to CSV for Excel or Google Sheets

If you want your data in a spreadsheet, you can export it to CSV format.

Django doesn’t have a built-in command for this, but you can write a simple script.

Here’s an example that exports all entries from a model:

Example:

Let’s say you have a model like this:

# models.py
from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.CharField(max_length=100)

To export it to CSV:

# export_books.py
import csv
from myapp.models import Book

with open('books.csv', 'w', newline='') as file:
    writer = csv.writer(file)
    writer.writerow(['Title', 'Author'])

    for book in Book.objects.all():
        writer.writerow([book.title, book.author])

Run this script with Django’s shell:

python manage.py shell < export_books.py

Now you have a books.csv file you can open in Excel or Google Sheets.

Method 4: Use Django Admin Actions

If your model is registered in the Django admin, you can create a custom admin action that lets you export data directly from the interface.

Here’s a quick example:

# admin.py
import csv
from django.http import HttpResponse
from .models import Book

@admin.action(description='Export selected books to CSV')
def export_to_csv(modeladmin, request, queryset):
    response = HttpResponse(content_type='text/csv')
    response['Content-Disposition'] = 'attachment; filename=books.csv'
    writer = csv.writer(response)
    writer.writerow(['Title', 'Author'])

    for book in queryset:
        writer.writerow([book.title, book.author])

    return response

class BookAdmin(admin.ModelAdmin):
    actions = [export_to_csv]

admin.site.register(Book, BookAdmin)

Now you can select rows in the Django admin and export them. Easy and user-friendly.

FAQs

Can I export data in XML format instead of JSON?

Yes! Just add the --format option:

python manage.py dumpdata --format=xml > db.xml

What’s the best format for backups?

JSON is great for Django-to-Django transfers. SQL (using pg_dump or sqlite3 .dump) is better for full database backups.

Can I automate backups?

Totally. Set up a cron job or a simple Python script that runs dumpdata on a schedule and saves the file to cloud storage.

Wrapping Up

Exporting your database in Django doesn’t have to be a big deal. With built-in commands like dumpdata, or even custom scripts for CSV exports, you can handle data safely and with confidence. And once you get the hang of it, you’ll probably use these tools all the time.