{"title":"django.contrib.formtools","version":"1.8","locale":"en","docname":"ref/contrib/formtools/index","url":"/en/1.8/ref/contrib/formtools/","canonical":"https://djangodocs.dev/en/1.8/ref/contrib/formtools/","summary":"A set of high-level abstractions for Django forms ( django.forms ). Historically, Django shipped with django.contrib.formtools – a collection of assorted utilities…","html":"

django.contrib.formtoolsLink to this heading#

\n

A set of high-level abstractions for Django forms (django.forms).

\n

Historically, Django shipped with django.contrib.formtools – a collection\nof assorted utilities that are useful for specific form use cases. This code is\nnow distributed separately from Django, for easier maintenance and to trim the\nsize of Django’s codebase. In Django 1.8, importing from\ndjango.contrib.formtools will no longer work.

\n

The new formtools package is named django-formtools, with a main module\ncalled formtools. Version 1.0 includes the same two primary features that\nthe code included when it shipped with Django: a helper for form previews and a\nform wizard view.

\n

See the official documentation for more information.

\n
\n

How to migrateLink to this heading#

\n

If you’ve used the old django.contrib.formtools package follow these\ntwo easy steps to update your code:

\n
    \n

  1. Install version 1.0 of the third-party django-formtools package.

    2. \n

  2. Change your app’s import statements to reference the new packages.

    \n

    For example, change:

    \n
    Code
    from django.contrib.formtools.wizard.views import WizardView\n
    \n

    to:

    \n
    Code
    from formtools.wizard.views import WizardView\n
    \n
    3. \n
\n

The code in version 1.0 of the new package is the same (it was copied directly\nfrom Django), so you don’t have to worry about backwards compatibility in terms\nof functionality. Only the imports have changed.

\n
","rootId":"django-contrib-formtools","toc":[{"title":"How to migrate","anchor":"how-to-migrate","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API Reference","url":"/en/1.8/ref/"},{"docname":"ref/contrib/index","title":"contrib packages","url":"/en/1.8/ref/contrib/"}],"prev":{"docname":"ref/contrib/flatpages","title":"The flatpages app","url":"/en/1.8/ref/contrib/flatpages/"},"next":{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/en/1.8/ref/contrib/gis/"},"formats":{"html":"/en/1.8/ref/contrib/formtools/","markdown":"/en/1.8/ref/contrib/formtools.md","json":"/en/1.8/ref/contrib/formtools.json"},"source":"https://github.com/django/django/blob/stable/1.8.x/docs/ref/contrib/formtools/index.txt","official":"https://docs.djangoproject.com/en/1.8/ref/contrib/formtools/","inVersions":["1.8"],"inLocales":["en"]}