Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Captcha Field for Django that uses images as puzzles that humans must arrange correctly to validate the field.
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.gitignore Added the README file
AUTHORS Loaded in the initial project


Check out a demo at

Django Puzzle Captcha is a Form Field for django forms that adds a special type of captcha to your form and validates it during form validation.

The captcha is unique in that it is an image split up into different pieces like a puzzle, and it uses javascript to allow the user to drag and drop the pieces of the puzzle to put them in the correct order.

Using this field has three parts.

  1. Add "puzzle_captcha" to your installed apps and run the "syncdb" management command to setup the required database tables.
  2. Load in images to be used as puzzles. This can be done either through the admin interface or through the built in load_images management command:
python load_images <path_to_folder_containing_images>
  1. Add a PuzzleCaptchaField to your form, like so:
from django import forms
from puzzle_captcha.fields import PuzzleCaptchaField

class MyForm(forms.Form):
    captcha = PuzzleCaptchaField()

That's pretty much it.

Something went wrong with that request. Please try again.