Flask CAPTCHA Integration
Set up a Flask CAPTCHA in your view with a few lines of Python. TrustCaptcha stops bot spam on logins, signups and contact forms, and a small @verify_trust_captcha decorator lets you reuse the check across views. EU-hosted, GDPR-compliant, no image puzzles.
Quickstart
How the integration works
1. Create a CAPTCHA
Create a user account or log in with an existing one. Then create a new CAPTCHA or pick an existing one. If you want to try TrustCaptcha first, every plan comes with a 14-day free trial.
The CAPTCHA overview page shows your site key and license key, and you create your API key there. Add your website’s domains to the authorized domains in the CAPTCHA security rules so they can use your CAPTCHA.


2. Add the CAPTCHA widget to your Jinja template
Drop the TrustCaptcha widget into the Jinja form template your Flask view renders. The widget runs the CAPTCHA in the background and adds a hidden tc-verification-token field on submit, which arrives on request.form like any other input.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<form method="post" action="{{ url_for('submit') }}">
<input type="email" name="email" required>
<trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
<button type="submit">Send</button>
</form>The CAPTCHA widget will then be displayed inside your form:

Need detailed information about the CAPTCHA widget integration?
Our documentation has the full widget reference, including themes, languages and custom design.
Read the documentation
3. Validate the token in your Flask view
In your Flask view, take the verification token from request.form, look up the result via our Python library, and decide whether to accept the request.
First, install our TrustCaptcha Python library:
pip install "trustcaptcha>=3.0.0,<4.0.0"Then validate the token inside your Flask view and act on the result:
from flask import Flask, request, render_template, redirect, url_for
from trustcaptcha.trust_captcha import TrustCaptcha
app = Flask(__name__)
@app.post("/contact")
def submit():
token = request.form.get("tc-verification-token", "")
try:
trust_captcha = TrustCaptcha("<your_api_key>")
result = trust_captcha.get_verification_result(token)
except Exception:
return render_template("contact.html", error="CAPTCHA verification failed."), 400
if not result.verification_passed or result.score > 0.5:
return render_template("contact.html", error="CAPTCHA verification failed."), 400
# CAPTCHA passed — process the request
return redirect(url_for("contact_success"))Need detailed information about the Flask CAPTCHA integration?
For full step-by-step instructions, including a reusable @verify_trust_captcha decorator, please read our documentation.
Read the documentation
Other backend framework instead of Flask?
If you use a different framework, pick the matching recipe here. If your framework isn’t listed, your software developers can integrate the verification themselves using our documentation or ask our support team for a pre-built integration.
4. Test your integration
TrustCaptcha is now active. Send a test request and check that it goes through.

FAQs
Where does the Flask CAPTCHA check go?
Can I run the CAPTCHA verification as a Flask decorator?
How do I share the SDK across my Flask app?
Does TrustCaptcha work with Flask blueprints?
Where should I keep the CAPTCHA API key?
TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.


Protect your Flask application with TrustCaptcha in just a few steps!
- EU-hosted & GDPR-compliant
- No puzzles
- Try free for 14 days