Last Updated : 23 Jul, 2025
A shopping cart allows users to collect and manage items they want to purchase before proceeding to checkout. We will build a simple shopping cart using Django and learn how to create models, views, templates and URLs to add, view and remove items from the cart—step by step.
Create Django Project and AppPrerequisites:
To start the project and app use this command
django-admin startproject ecommerce
cd ecommerce
python manage.py startapp cart
Now add this app to the 'settings.py'.
Define Models in models.pyYour database schema is the foundation of the app. We'll create two models:
from django.db import models
from django.contrib.auth.models import User
class Product(models.Model):
name = models.CharField(max_length=100)
description = models.TextField(null=True)
price = models.DecimalField(max_digits=10, decimal_places=2)
image = models.ImageField(upload_to='products/')
def __str__(self):
return self.name
class CartItem(models.Model):
product = models.ForeignKey(Product, on_delete=models.CASCADE)
quantity = models.PositiveIntegerField(default=0)
user = models.ForeignKey(User, on_delete=models.CASCADE)
date_added = models.DateTimeField(auto_now_add=True)
def __str__(self):
return f'{self.quantity} x {self.product.name}'
Register Models in Admin
Register your models so you can add/edit products and cart items via Django’s admin interface:
Python
from django.contrib import admin
from .models import Product, CartItem
admin.site.register(Product)
admin.site.register(CartItem)
Create Views in views.py
The views will handle displaying products, managing the cart, adding/removing items and rendering appropriate templates.
from django.shortcuts import render, redirect
from .models import Product, CartItem
def product_list(request):
products = Product.objects.all()
return render(request, 'myapp/index.html', {'products': products})
def view_cart(request):
cart_items = CartItem.objects.filter(user=request.user)
total_price = sum(item.product.price * item.quantity for item in cart_items)
return render(request, 'myapp/cart.html', {'cart_items': cart_items, 'total_price': total_price})
def add_to_cart(request, product_id):
product = Product.objects.get(id=product_id)
cart_item, created = CartItem.objects.get_or_create(product=product,
user=request.user)
cart_item.quantity += 1
cart_item.save()
return redirect('cart:view_cart')
def remove_from_cart(request, item_id):
cart_item = CartItem.objects.get(id=item_id)
cart_item.delete()
return redirect('cart:view_cart')
def home(request):
return HttpResponse('Hello, World!')
Set Up Templates for User Interface Product List - index.htmlAdding a cart to a Django web page is a crucial skill for e-commerce apps. If you're looking to build more complex applications, the Django Web Development Course will guide you through advanced concepts.
Displays all products with their image, description, price and an Add to Cart button.
HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Product Catalog</title>
<style>
/* Add CSS styles for flex container and items */
.product-list {
display: flex;
flex-wrap: wrap; /* Allow items to wrap to the next row if necessary */
justify-content: space-between; /* Space items evenly along the main axis */
list-style: none; /* Remove list styles */
padding: 0;
}
.product-item {
flex: 1; /* Grow to fill available space evenly */
max-width: 30%; /* Limit item width to avoid overcrowding */
margin: 10px; /* Add spacing between items */
border: 1px solid #ccc; /* Add a border for visual separation */
padding: 10px;
text-align: center;
}
/* Style the "Buy Now" button */
.buy-now-button {
display: block;
margin-top: 10px;
background-color: #007bff;
color: #fff;
text-decoration: none;
padding: 5px 10px;
border-radius: 5px;
}
</style>
</head>
<body>
<h1>Product Catalog</h1>
<ul class="product-list">
{% for product in products %}
<li class="product-item">
<img src="{{ product.image.url }}" alt="{{ product.name }}" width="200" height="150">
<h2>{{ product.name }}</h2>
<p>{{ product.description }}</p>
<p>Price: ${{ product.price }}</p>
<a href="#" class="buy-now-button">Buy Now</a>
<a class="buy-now-button" href="{% url 'cart:add_to_cart' product.id %}">Add to Cart</a>
</li>
{% endfor %}
</ul>
</body>
</html>
Cart View - cart.html
Shows the current items in the cart with quantity, price and a remove option, along with the total cost.
HTML
<!-- cart/cart.html -->
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
<style>
/* Add CSS styles for flex container and items */
.product-list {
display: flex;
flex-wrap: wrap; /* Allow items to wrap to the next row if necessary */
justify-content: space-between; /* Space items evenly along the main axis */
list-style: none; /* Remove list styles */
padding: 0;
}
.product-item {
flex: 1; /* Grow to fill available space evenly */
/* Limit item width to avoid overcrowding */
margin: 10px; /* Add spacing between items */
border: 1px solid #ccc; /* Add a border for visual separation */
padding: 10px;
text-align: center;
}
/* Style the "Buy Now" button */
.buy-now-button {
display: block;
margin-top: 10px;
background-color: #007bff;
color: #fff;
text-decoration: none;
padding: 5px 10px;
border-radius: 5px;
}
</style>
</head>
<body>
<h1>Your Shopping Cart</h1>
<div class="product-list">
{% for item in cart_items %}
<div class="product-item">
<p>{{ item.product.name }} ({{ item.quantity }})</p>
<p>Price: ${{ item.product.price }}</p>
<a href="{% url 'cart:remove_from_cart' item.id %}">Remove</a>
</div>
{% empty %}
<p>Your cart is empty.</p>
{% endfor %}
</div>
<p>Total Price: ${{ total_price }}</p>
<a href="{% url 'cart:product_list' %}">Continue Shopping</a>
</body>
</html>
Configure URLs
In cart/urls.py, map URLs to the views:
Python
from django.urls import path
from . import views
app_name = 'cart'
urlpatterns = [
path('', views.product_list, name='product_list'),
path('/home', views.home, name='home'),
path('cart/', views.view_cart, name='view_cart'),
path('add/<int:product_id>/', views.add_to_cart, name='add_to_cart'),
path('remove/<int:item_id>/', views.remove_from_cart, name='remove_from_cart'),
]
Include these URLs in the main ecommerce/urls.py:
Python
from django.contrib import admin
from django.urls import path, include
from django.conf.urls.static import static
from django.conf import settings
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('cart.urls')),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
Configure Django to serve static and media files during development. In your project's settings.py file, add the following:
Python
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent.parent
STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / "static"]
MEDIA_URL = '/media/'
MEDIA_ROOT = BASE_DIR / "media"
Apply Migrations and Run the Server
Generate and apply database migrations:
python manage.py makemigrations
python manage.py migrate
Run the server with the help of following command:
python manage.py runserver
Now, Go to the http://127.0.0.1:8000/admin/ and add the Images, name and its description.
Output
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4