Django ORM – Inserting, Updating & Deleting Data

Prerequisite: Django models

Django lets us interact with its database models, i.e. add, delete, modify and query objects, using a database-abstraction API called ORM(Object Relational Mapper). This article discusses all the useful operations we can perform using Django ORM.

For demonstration purposes, we will use the following Django models.





class Album(models.Model):
    title = models.CharField(max_length = 30)
    artist = models.CharField(max_length = 30)
    genre = models.CharField(max_length = 30)
    def __str__(self):
        return self.title
class Song(models.Model):
    name = models.CharField(max_length = 100)
    album = models.ForeignKey(Album, on_delete = models.CASCADE)
    def __str__(self):


We can access the Django ORM by running the following command inside our project directory.

python shell

This brings us to an interactive Python console. Assuming that our models exist in myProject/albums/ we can import our models using the following command:

>>> from books.models import Song, Album

Adding objects

To create an object of model Album and save it into the database, we need to write the following command:

>>> a = Album(title = "Divide", artist = "Ed Sheeran", genre = "Pop")

To create an object of model Song and save it into the database, we need to write the following command:

>>> s = Song(name = "Castle on the Hill", album = a)

Retrieving objects

Let us add 2 more Albums records for the sake of demonstration.

>>> a = Album(title = "Abbey Road", artist = "The Beatles", genre = "Rock")
>>> a = Album(title = "Revolver", artist = "The Beatles", genre = "Rock")

To retrieve all the objects of a model, we write the following command:

>>> Album.objects.all()
<QuerySet [<Album: Divide>, <Album: Abbey Road>, <Album: Revolver>]>

The output is a QuerySet, or a set of objects that match the query. Notice that the name printed is the output of the __str__() function.

We can also filter queries using the functions filter(), exclude() and get(). The filter() function returns a QuerySet having objects that match the given lookup parameters.

>>> Album.objects.filter(artist = "The Beatles")
<QuerySet [<Album: Abbey Road>, <Album: Revolver>]>

The exclude() function returns a QuerySet having objects other than those matching the given lookup parameters.

>>> Album.objects.exclude(genre = "Rock")
<QuerySet [<Album: Divide>]>

The get() function returns a single object which matches the given lookup parameter. It gives an error when the query returns multiple objects.

>>> Album.objects.get(pk = 3)
<QuerySet [<Album: Revolver>]>

Modifying existing objects

We can modify an existing object as follows:

>>> a = Album.objects.get(pk = 3)
>>> a.genre = "Pop"

Deleting objects

To delete a single object, we need to write the following commands:

>>> a = Album.objects.get(pk = 2)
>>> a.delete()
>>> Album.objects.all()
<QuerySet [<Album: Divide>, <Album: Revolver>]>

To delete multiple objects, we can use filter() or exclude() functions as follows:

>>> Album.objects.filter(genre = "Pop").delete()
>>> Album.objects.all()
<QuerySet []>
My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using or mail your article to See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.

Improved By : NaveenArora

Article Tags :

Be the First to upvote.

Please write to us at to report any issue with the above content.