How to Handle Form in Flask: Fix and Best Practices

To handle a form in Flask, use the request object to get form data inside a route that accepts POST requests. Make sure your HTML form uses method="POST" and your Flask route checks request.method == 'POST' before accessing request.form.

Why This Happens

When handling forms in Flask, a common mistake is trying to access form data without checking the request method or using the wrong method in the HTML form. This causes errors or empty data because Flask does not receive the form data as expected.

python

from flask import Flask, request

app = Flask(__name__)

@app.route('/submit', methods=['GET'])
def submit():
    if request.method == 'POST':
        name = request.form['name']  # Trying to get form data on GET request
        return f'Hello, {name}!'
    return 'Please submit the form using POST method.'

if __name__ == '__main__':
    app.run(debug=True)

Output

werkzeug.exceptions.BadRequestKeyError: 400 Bad Request: The browser (or proxy) sent a request that this server could not understand.

The Fix

Change the route to accept POST requests and check the request method before accessing form data. Also, ensure the HTML form uses method="POST" to send data correctly.

python

from flask import Flask, request, render_template_string

app = Flask(__name__)

form_html = '''
<form method="POST" action="/submit">
  <label for="name">Name:</label>
  <input type="text" id="name" name="name">
  <input type="submit" value="Submit">
</form>
'''

@app.route('/submit', methods=['GET', 'POST'])
def submit():
    if request.method == 'POST':
        name = request.form.get('name', '')
        return f'Hello, {name}!'
    return render_template_string(form_html)

if __name__ == '__main__':
    app.run(debug=True)

Output

When you open /submit in a browser, you see a form with a name input and submit button. After submitting, the page shows: Hello, [your name]!

Prevention

Always specify methods=['GET', 'POST'] in your route when handling forms. Check request.method before accessing request.form. Use request.form.get('field_name') to avoid errors if the field is missing. Validate and sanitize form inputs to keep your app safe.

Related Errors

BadRequestKeyError: Happens when you try to access a form key that does not exist. Use request.form.get() to avoid this.

Method Not Allowed: Occurs if your route does not accept the form's method (usually POST). Add methods=['POST'] to fix.

Key Takeaways

Use methods=['GET', 'POST'] in your Flask route to handle form submissions.

Check request.method == 'POST' before accessing form data.

Use request.form.get('field_name') to safely get form inputs.

Ensure your HTML form uses method="POST" to send data correctly.

Validate and sanitize form inputs to prevent security issues.