Integrating GraphQL into Django

 Integrating graphql into django

Integrating graphql into django


GraphQL is an API querying language which was developed at Facebook in the year 2012 for internal use. It was later open-sourced in 2015. According to the Graphql official website :

“GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.”

The client can ask for the data they need in the response without any additional data, meaning you control the structure of the data you want. Access to many resources in a single request.
Talking about the powers of GraphQL is beyond the focus of this article, visit the official website for more information on GraphQL.

In this tutorial, we will focus on how we can integrate GraphQL into a Django project and effectively use it to query API for effective result.

Prerequisite for this tutorial:

  • You have python installed on your local machine
  • Basic knowledge of python
  • Basic knowledge of Django
  • Internet connection

We will be building a simple product catalog for use in this integration which we will expose the data via our GraphQL endpoint. So let’s get to work.

Project Setup

Creating our Project folder

To begin, let’s create a directory for our new project we will be working on, open your terminal and navigate to the folder you will want to save the project. Run the following command:

let change the current directory we are on now to the newly created directory

Creating and activating our project virtual environment

It’s also important in python to always create a virtual environment for any project you begin which there will be need to install new packages, this ensures that the packages are always unique to the projects and will not result in updating packages in other projects on your local machine that can end up breaking your working projects.

let’s run the below command:

Here I called my new environment env, which creates our python environment in a directory env.
Next, we need to activate the environment to get us working for here.

Installing Django in our environment

Now that we have our environment, we need to install Django in it, It is really saved to install any version of Django now and it will not affect the versions use in other projects we have on our local machine.  Let’s install Django by running the following commands.

Creating the project

Now that we have Django installed, let now move on to create our project by running the following command:

Here we are using the django command-line tool django-admin to create our project, which will be created in a directory call product_catalog.

Next, we will need to navigate into the product_catalog directory by running the following command:

where we have a directory structure similar to:

Creating our catalog app

Sections of the Django project are call apps,  Massive Django projects can have as many apps as possible. We will need to create one app for our product catalog call catalog. So we will proceed by running the following command:

The command creates a directory call catalog with the following structure

The entire project structure should now look like this

Next lets structure our catalog app models. in the file inside the catelog folder, lets add the following code

Here we define our Category model to organize the products in categories and then our Product model too with a relationship to the Category.

We need to register these models in our site admin, so open the file in the catalog app and add the following code:

Here we are just doing a basic registration and allowing Django the handle the rendering with the default settings.

Next, we need to make our app know by the project by registering it in the INSTALLED_APPS list on the file.

Since the project we are working on is a simple one, we will stick to the default database configuration for Django to use the SQLite database. Next is for use to prepare to migrate our catalog app tables by running the following command:

Next, we migrate our database by running the migration command below

This will migrate our catalog models alongside Django related models for our database.

Next, we want to create our super user for the Django admin dashboard to enable us to create some categories and products from the dashboard. Now run the following command and follow the instruction the follows:

Next, we start our development server by running:

By default, Django start our server on port 8000, but you can follow the command with a port number

now visit on the browser to see our app running

App home page

App home page

You can navigate to to access the admin site using the credential we set up during the create superuser step above.

Django admin site

Django admin siteYou can proceed to add some categories and products to the app.

Integrating GraphQL

Now we will be integrating Graphql into the project to query our products. We will be using a package called Graphene-Django.

Let’s proceed to install Graphene-Django by running the following command on the terminal:
Note: validate that your environment is still active.

Next, we will need to register the newly installed package in the INSTALLED_APPS list in


“django.contrib.staticfiles”, # Required for GraphiQL

If you notice we also registered django.contrib.staticfiles , this is required by Graphene-Django for rendering.

Next is for us to create an entry point to our graph. So let’s add the following lines to our :

this endpoint is where all communication to our graph will be made. looking at the above code we set graphiql=True  which will enable the browser API for our graph, but you can set it to False if you don’t want the browser to be used for our graph.

Next is to tell graphene-Django where to find our schema. The schema is like the structure of our graph.  Add the following code to our

This will point to the file we are going to create in our catalog app.
Next, create the file in our catalog app folder with the following content :

Here we created our schema for the Category and Product model by creating two class that inherits from the DjangoObjectType from the graphene_django module, supplying the models and the model fields we want to expose in our Graphql.

Next, we created a Query class that inherits from graphene.ObjectType class and supply the configuration for our Graphql queries. here we open up products and categories which is queryset are resolved by our resolve_products and resolve_categories methods of the class. These methods accept two required parameter (root and info), while the resolve_products accept an additional parameter category use for simple product filter by category.

Testing our app
Next, we start our app again if it has been shut down by running

visit on your browser to see the interactive screen for our Graphql.

Graphql preview

Graphql previewYou can play around with some of the following commands to query the data that was added via the admin site

Graphql response preview

Graphql response previewOther commands to try out include:

Here we added a filter to the query to query product in a particular category.

Creating and Updating

Now we can only query but can create or update. We can add the create and update features to our integration by updating our code  to add this after the ProductType  class:

Here we introduce six new classes to handle our mutations. Class names are self-explanatory for what it will do. The final class Mutation is where the mutation actions get to register, which we then proceed to register our mutation in our Schema constructor

We can test out our mutations by these queries. Creating and updating categories

Creating and updating products


At the end of this brief tutorial, we have been able to integrate Graphql into Django using the Graphene-Django package. This package has a load of features that we are unable to introduce in this tutorial, deleting information and many other features Graphql offers. To get the best out of this package for your project, you can check out the package’s official documentation here. You can also read more about Graphql if you are not familiar with its rich features and functionalities.  The source code for this tutorial can be access on Github. Thanks for reading and practicing along.

About the author

Stay Informed

It's important to keep up
with industry - subscribe!

Stay Informed

Looks good!
Please enter the correct name.
Please enter the correct email.
Looks good!

Related articles


Creating Our Own Chat GPT

In June, OpenAI announced that third-party applications' APIs can be passed into the GPT model, opening up a wide range of possibilities for creating ...

Building Machine Learning-Enabled Web Applications with Django and Scikit-Learn Introduction

Machine Learning (ML) has become an integral part of modern web applications due to its ability to improve user experiences, streamline processes, ...

Building Rest API With Django Using Django Rest Framework and Django Rest Auth

Building Rest API seems to be complex when trying to achieve this on your own with Django,  thanks to the Django Rest framework project which has ...

No comments yet

Sign in

Forgot password?

Or use a social network account


By Signing In \ Signing Up, you agree to our privacy policy

Password recovery

You can also try to

Or use a social network account


By Signing In \ Signing Up, you agree to our privacy policy