Hello Coders!

This short article explains how to fix "Cannot import name TextField from wtforms" error that recently bumped after WTForms library update to version 3.x. For newcomers, WTForms is a flexible forms validation and rendering library for Python/Flask web development. It can work with whatever web framework and template engine you choose. It supports data validation, CSRF protection, internationalization (I18N).

Thanks for reading! - Content provided by App Generator.

Error Text

In case your legacy app uses WTForms without an explicit version in requirements.txt file (like me) the next compilation might lead to a runtime error in case TextField type provided by the concerned library occurs somewhere in the codebase.

from wtforms import TextField
>> ImportError: cannot import name 'TextField' from 'wtforms'

The above error occurs when the TextField property is used with WTForms version 3.0 or above because the wtforms.TextField deprecated in favor of wtforms.StringField.

How to fix it

Solution 1 - Replace TextField type with StringField

Note: This solution works with WTForms 3.x and 2.x versions

from wtforms import StringField
// replace all TextField usages with StringField type 

Solution 2 - Use the latest stable 2.x version of WTForms

// Use 2.x version
pip install WTForms==2.3.3

Using an older version provides a quick fix for your codebase but is not recommended in the long run.

Free Sample

For this open-source sample, I've used the 2nd solution where the Cannot import name TextField from wtforms error is solved by freezing the WTForms version in requirements.txt file, without a codebase update.

• 👉 Datta Able Flask - Source Code
• 👉 Datta Able Flask - LIVE deployment

Thanks for reading! For more resources, please access:

• WTForms - official documentation
• Flask - library documentation
• Join the AppSeed community on Discord and connect to other fellow developers.