Skip to content
Fieldset Rendering For Non-Admin Forms
Pull request Compare This branch is 68 commits ahead, 3 commits behind OddBloke:master.
Latest commit 20f4671 Sep 30, 2011 Steve Ivy fix bug with concatenating lists and tuples


django-formfieldset is a simple Django app that provides a mix-in class for admin-like fieldset rendering.


  • Fieldset functionality similar to ModelAdmin
  • Shorthand rendering functions with fieldsets both for whole forms and for individual fieldsets
    • render as P
    • render as TABLE
    • render as UL
  • Template strings are class attributes
  • Overrides nothing in django.forms.Form


  1. Add "django-formfieldset" directory to your Python path.
  2. Add "formfieldset" to your INSTALLED_APPS tuple found in your settings file. (optional - to be able to run tests)

Testing & Example

There is an example project in the example/ directory. To run automated tests for django-formfieldset run the following command in example/ directory:

python example/ test formfieldset

To run the example project:

python example/ runserver

Then you can visit http://localhost:8000/ to view the example. Example project also serves as detailed documentation for formfieldset.

Code examples will be highlighted if you have pygments installed.


  1. Create your form with FieldsetMixin.
  2. Add a fieldsets attribute to your form. See admin docs for detailed explanation.
  3. Render your form with fieldset enabled methods:
    • You can use iter_fieldsets() for custom form rendering. It will yield Fieldset objects. Fieldsets act as iterators for widgets in them.
    • You can use as_fieldset_table(), as_fieldset_ul() and as_fieldset_p() methods that act like built-in as_* method except fieldset support.

Tutorials & How-to's

See Also

Something went wrong with that request. Please try again.