The tutorial, Python flask file upload example, will show you how to upload single file using Python 3 and Flask technologies. You may also find useful example on file upload on different technologies.

Related Posts:


Have Python installed in Windows (or Unix)
Pyhton version and Packages
I am using Python 3.6.6 version

Example with Source Code

Please go through the following steps in order to implement Python flask file upload example.

Step 1. Create the below script(py is the extension to indicate Python script) where we import the flask module. Notice how we create flask instance. Here we need to assign secret key otherwise flash will not work in Python.

In the below script we import the required module – Flask. If you do not have this module then install it.

Here we have also specified the file upload folder and maximum size of the file to be uploaded as 16MB.

from flask import Flask

UPLOAD_FOLDER = 'D:/uploads'

app = Flask(__name__)
app.secret_key = "secret key"
app.config['MAX_CONTENT_LENGTH'] = 16 * 1024 * 1024

Step 2. Next we need script. This script is the perfect instance of Python flask file upload example. It defines all required URIs for performing file upload operations.

We have used upload.html page for uploading file to the desired directory.

We show success message on successful file upload.

import os
#import magic
import urllib.request
from app import app
from flask import Flask, flash, request, redirect, render_template
from werkzeug.utils import secure_filename

ALLOWED_EXTENSIONS = set(['txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif'])

def allowed_file(filename):
	return '.' in filename and filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS
def upload_form():
	return render_template('upload.html')

@app.route('/', methods=['POST'])
def upload_file():
	if request.method == 'POST':
        # check if the post request has the file part
		if 'file' not in request.files:
			flash('No file part')
			return redirect(request.url)
		file = request.files['file']
		if file.filename == '':
			flash('No file selected for uploading')
			return redirect(request.url)
		if file and allowed_file(file.filename):
			filename = secure_filename(file.filename)['UPLOAD_FOLDER'], filename))
			flash('File successfully uploaded')
			return redirect('/')
			flash('Allowed file types are txt, pdf, png, jpg, jpeg, gif')
			return redirect(request.url)

if __name__ == "__main__":

Step 3. Now we need template page for uploading file. This is upload.html page kept under subdirectory – templates. You can use this page for uploading single file.

<!doctype html>
<title>Python Flask File Upload Example</title>
<h2>Select a file to upload</h2>
	{% with messages = get_flashed_messages() %}
	  {% if messages %}
		<ul class=flashes>
		{% for message in messages %}
		  <li>{{ message }}</li>
		{% endfor %}
	  {% endif %}
	{% endwith %}
<form method="post" action="/" enctype="multipart/form-data">
			<input type="file" name="file" autocomplete="off" required>
		<input type="submit" value="Submit">

Testing of the application

When you open the default URL http://localhost:5000 then you will see below page:

python flask file upload

When you select a file for upload: you can select only the specified types of files as in the script.

python flask file upload

When you click on Submit button after selecting a file or files:

python flask file upload

Now you check the uploaded file in the destination:

python flask file upload

You may like to read Python Flask Multiple Files Upload Example.

Source Code

download source code

That’s all. Thanks for reading.


23 thoughts on “Python Flask File Upload Example

  1. This only works with a HTML form – how can you correct this so you can call it from any external client, ex postman ? if you try from postman request.files always will be 0 len.

  2. Hi,
    Thanks for posting this solution. I am trying to create a python web app in VS2019 using this code. I have installed flask and werkzeug but I am getting an error on the import urllib.request (unresolved import ‘urllib.request’) . Do you have any advice on how to resolve this please? Many thanks!

  3. Thanks a lot for the detailed instructions. I am getting a 405 error though when submitting the request. Any idea how to resolve this?

  4. this program can be used to upload only single file, how can i upload multiple files.
    the html page provided here, is selecting multiple files but uploading only one.

  5. Just wanted to thank you for how bare-bones this tutorial is. Got me exactly what I needed, when I needed it

Leave a Reply

Your email address will not be published. Required fields are marked *