Handling File Uploads in Django


File uploads are a common feature in web applications, and Django provides a convenient way to handle them. In this guide, we'll explore how to handle file uploads in Django, complete with sample code.


Before you begin, make sure you have the following prerequisites in place:

  • Django: You should have Django installed. If not, use
    pip install django
    to install it.
  • Django Project: You should have a Django project set up. If not, refer to the guide on creating your first Django project.

Step 1: Create an Upload Form

Start by creating an HTML form for file uploads. This form typically includes a file input field.

Sample Code

Here's an example of an upload form in your HTML template:

<form method="POST" enctype="multipart/form-data" action="{% url 'upload' %}">
<input type="file" name="file" accept="image/*" required>
<input type="submit" value="Upload">

Step 2: Handle File Upload

Create a view in Django to handle the file upload. This view should validate and process the uploaded file.

Sample Code

Here's an example of a Django view to handle file uploads:

from django.shortcuts import render
from django.core.files.storage import FileSystemStorage
def upload_file(request):
if request.method == 'POST' and request.FILES['file']:
uploaded_file = request.FILES['file']
fs = FileSystemStorage()
fs.save(uploaded_file.name, uploaded_file)
return render(request, 'upload_success.html', {'file_url': fs.url(uploaded_file.name)})
return render(request, 'upload_form.html')

Step 3: Display Upload Success

After handling the file upload, you can display a success message or the uploaded file to the user.

Sample Code

Here's an example of an upload success template:

<h2>Upload Successful</h2>
<img src="{{ file_url }}" alt="Uploaded File">

Step 4: Configure URL Patterns

Configure URL patterns to access the upload form and success page.

Sample Code

Here's an example of URL routing in your app's


from django.urls import path
from . import views
urlpatterns = [
path('upload/', views.upload_file, name='upload'),


Handling file uploads in Django is a crucial feature for various web applications. By following these steps, you can create a file upload functionality and enhance your web application's capabilities.