Add formfield_overrides example. Add label and help props.

Author: vsdudakov

docs/build.py

@@ -42,6 +42,12 @@ def read_cls_docstring(cls):
 
 def get_versions():
     return [
+        {
+            "version": "0.3.2",
+            "changes": [
+                "Add formfield_overrides example. Add label and help props.",
+            ],
+        },
         {
             "version": "0.3.1",
             "changes": [
@@ -588,6 +594,23 @@ def get_page_context(page_url):
                     "type": "alert-warning",
                     "content": "See <a href='https://ant.design/components/overview' target='_blank'>antd components</a> for more details (e.g. how they look).",
                 },
+                {
+                    "type": "text",
+                    "content": "Use <code>formfield_overrides</code> to customize widget props per field. You can set <code>label</code> for a custom field label and <code>help</code> for description text below the field:",
+                },
+                {
+                    "type": "code-python",
+                    "content": '''formfield_overrides = {
+    "username": (
+        WidgetType.SlugInput,
+        {
+            "required": True,
+            "label": "Custom label",
+            "help": "Detailed description of the field",
+        },
+    ),
+}''',
+                },
             ]
         # inlines
         case "#registering-inlines":

docs/index.html

@@ -196,6 +196,14 @@ <h4 class="title">FastAdmin</h4>
 
               <ul class="nav flex-column">
 
+                <li class="nav-item">
+                  <a class="nav-link" href="#v0_3_2">v0.3.2</a>
+                </li>
+                
+                <li class="nav-item">
+                  <a class="nav-link" href="#v0_3_1">v0.3.1</a>
+                </li>
+                
                 <li class="nav-item">
                   <a class="nav-link" href="#v0_3_0">v0.3.0</a>
                 </li>
@@ -307,7 +315,7 @@ <h1>FastAdmin | Documentation</h1>
               <div class="row">
                 <div class="col-sm-6 col-lg-4">
                   <ul class="list-unstyled">
-                    <li><strong>Version:</strong> 0.3.0</li>
+                    <li><strong>Version:</strong> 0.3.2</li>
                     <li>
                       <strong>Author:</strong>
                       <a href="mailto:[email protected]" target="_blank">
@@ -324,7 +332,7 @@ <h1>FastAdmin | Documentation</h1>
                     </li>
                     <li>
                       <strong>Updated:</strong>
-                      18 February 2026
+                      19 February 2026
                     </li>
                   </ul>
                 </div>
@@ -2799,6 +2807,53 @@ <h3>Form Field Types</h3>
 
 
 
+                  
+<p class="text-4">
+  Use <code>formfield_overrides</code> to customize widget props per field. You can set <code>label</code> for a custom field label and <code>help</code> for description text below the field:
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                  
+
+
+
+
+
+
+
+
+
+
+<pre>
+  <code class="language-python">
+formfield_overrides = {
+    "username": (
+        WidgetType.SlugInput,
+        {
+            "required": True,
+            "label": "Custom label",
+            "help": "Detailed description of the field",
+        },
+    ),
+}
+  </code>
+</pre>
+
+
+
+                
                 </section>
 
 
@@ -3163,6 +3218,56 @@ <h2>Changelog</h2>
 
 
 
+                <section id="v0_3_2">
+                <h3>v0.3.2</h3>
+
+                
+                  
+<p class="text-4">
+  Add formfield_overrides example. Add label and help props.
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                </section>
+
+              
+                <section id="v0_3_1">
+                <h3>v0.3.1</h3>
+
+                
+                  
+<p class="text-4">
+  Fix sqlalchemy required fields. Fix CI.
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                </section>
+
+              
                 <section id="v0_3_0">
                 <h3>v0.3.0</h3>
 

examples/fastapi_sqlalchemy/example.py

@@ -20,12 +20,7 @@ class UserModelAdmin(SqlAlchemyModelAdmin):
     list_filter = ("id", "username", "is_superuser")
     search_fields = ("username",)
     formfield_overrides = {  # noqa: RUF012
-        "username": (WidgetType.SlugInput, {"required": True,
-                                            # Changing the field label to a custom option
-                                            # "label": "Custom label",
-                                            # Adding a small text below the field to better understand the purpose of the field
-                                            # "help": "Detailed description of the field"
-                                            }),
+        "username": (WidgetType.SlugInput, {"required": True}),
         "password": (WidgetType.PasswordInput, {"passwordModalForm": True}),
         "avatar_url": (
             WidgetType.Upload,

frontend/src/components/form-container/index.tsx

@@ -1,4 +1,4 @@
-import {Col, Collapse, Divider, Form, Row, Typography} from "antd";
+import { Col, Collapse, Divider, Form, Row, Typography } from "antd";
 import type React from "react";
 import { useCallback, useEffect, useState } from "react";
 import { useTranslation } from "react-i18next";
@@ -103,9 +103,10 @@ export const FormContainer: React.FC<IFormContainer> = ({
           key={field.name}
           name={field.name}
           label={
-            getConf(field).form_widget_props?.label 
-            ? getConf(field)?.form_widget_props?.label 
-            : getTitleFromFieldName(field.name)}
+            getConf(field).form_widget_props?.label
+              ? getConf(field)?.form_widget_props?.label
+              : getTitleFromFieldName(field.name)
+          }
           rules={
             [
               ...(getConf(field).required
@@ -170,11 +171,14 @@ export const FormContainer: React.FC<IFormContainer> = ({
           }
         >
           {getWidget(getConf(field))}
-          {getConf(field).form_widget_props?.help && 
-            <Typography.Text type={"secondary"} style={{marginTop: ".35rem", display: "flex"}}>
+          {getConf(field).form_widget_props?.help && (
+            <Typography.Text
+              type={"secondary"}
+              style={{ marginTop: ".35rem", display: "flex" }}
+            >
               {getConf(field).form_widget_props?.help}
             </Typography.Text>
-          }
+          )}
         </Form.Item>
       ));
     },

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "fastadmin"
-version = "0.3.1"
+version = "0.3.2"
 description = "FastAdmin is an easy-to-use Admin Dashboard App for FastAPI/Flask/Django inspired by Django Admin."
 authors = ["Seva D <[email protected]>"]
 license = "MIT"