Add max_height to widget action props. Add highlight search results to widget action results. Add copy to clipboard to widget action results. Add expand results modal to widget action results. Add menu_section to model admins.

Author: vsdudakov

docs/build.py

@@ -44,6 +44,16 @@ def read_cls_docstring(cls):
 
 def get_versions():
     return [
+        {
+            "version": "0.4.6",
+            "changes": [
+                "Add max_height to widget action props.",
+                "Add highlight search results to widget action results.",
+                "Add copy to clipboard to widget action results.",
+                "Add expand results modal to widget action results.",
+                "Add menu_section to model admins.",
+            ],
+        },
         {
             "version": "0.4.5",
             "changes": [

docs/index.html

@@ -192,6 +192,10 @@ <h4 class="title">FastAdmin</h4>
 
               <ul class="nav flex-column">
 
+                <li class="nav-item">
+                  <a class="nav-link" href="#v0_4_6">v0.4.6</a>
+                </li>
+                
                 <li class="nav-item">
                   <a class="nav-link" href="#v0_4_5">v0.4.5</a>
                 </li>
@@ -371,7 +375,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.4.5</li>
+                    <li><strong>Version:</strong> 0.4.6</li>
                     <li>
                       <strong>Author:</strong>
                       <a href="mailto:vsdudakov@gmail.com" target="_blank">
@@ -388,7 +392,7 @@ <h1>FastAdmin | Documentation</h1>
                     </li>
                     <li>
                       <strong>Updated:</strong>
-                      07 March 2026
+                      11 March 2026
                     </li>
                   </ul>
                 </div>
@@ -951,6 +955,7 @@ <h3>Registering Models</h3>
 
 @register(User)
 class UserModelAdmin(TortoiseModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -1545,6 +1550,7 @@ <h3>Registering Models</h3>
 
 @register(User)
 class UserModelAdmin(DjangoModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -1965,6 +1971,7 @@ <h3>Registering Models</h3>
 
 @register(User, sqlalchemy_sessionmaker=sqlalchemy_sessionmaker)
 class UserModelAdmin(SqlAlchemyModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -2449,6 +2456,7 @@ <h3>Registering Models</h3>
 
 @register(User)
 class UserModelAdmin(PonyORMModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -3661,6 +3669,10 @@ <h3>Methods and Attributes</h3>
 class ModelAdmin(BaseModelAdmin):
     """This class is used to create admin model class."""
 
+    # Optional section name for grouping models in the left menu.
+    # Example of usage: menu_section = "Users"
+    menu_section: str | None = None
+
     # Normally, objects have three save options: “Save”, “Save and continue editing”, and “Save and add another”.
     # If save_as is True, “Save and add another” will be replaced
     # by a “Save as new” button that creates a new object (with a new ID) rather than updating the existing object.
@@ -4008,6 +4020,7 @@ <h3>Registering Inlines</h3>
 
 @register(User)
 class UserModelAdmin(TortoiseModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -4602,6 +4615,7 @@ <h3>Registering Inlines</h3>
 
 @register(User)
 class UserModelAdmin(DjangoModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -5022,6 +5036,7 @@ <h3>Registering Inlines</h3>
 
 @register(User, sqlalchemy_sessionmaker=sqlalchemy_sessionmaker)
 class UserModelAdmin(SqlAlchemyModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -5506,6 +5521,7 @@ <h3>Registering Inlines</h3>
 
 @register(User)
 class UserModelAdmin(PonyORMModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")
@@ -6190,6 +6206,7 @@ <h3>Methods and Attributes</h3>
     width: (
         tp.Literal[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24] | None
     ) = None,  # width in 1-24 grid system
+    max_height: int | None = None,
 ):
     """Conveniently add attributes to a widget action function:
 
@@ -6253,6 +6270,7 @@ <h3>Methods and Attributes</h3>
         wrapped.tab = tab
         wrapped.title = title
         wrapped.width = width
+        wrapped.max_height = max_height
         if description is not None:
             wrapped.short_description = description
         return wrapped
@@ -6497,6 +6515,103 @@ <h2>Changelog</h2>
 
 
 
+                <section id="v0_4_6">
+                <h3>v0.4.6</h3>
+
+                
+                  
+<p class="text-4">
+  Add max_height to widget action props.
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                  
+<p class="text-4">
+  Add highlight search results to widget action results.
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                  
+<p class="text-4">
+  Add copy to clipboard to widget action results.
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                  
+<p class="text-4">
+  Add expand results modal to widget action results.
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                  
+<p class="text-4">
+  Add menu_section to model admins.
+</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+                
+                </section>
+
+              
                 <section id="v0_4_5">
                 <h3>v0.4.5</h3>
 

examples/django_djangoorm/orm/models.py

@@ -99,6 +99,7 @@ class Meta:
 
 @register(User)
 class UserModelAdmin(DjangoModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")

examples/fastapi_ponyorm/example.py

@@ -38,6 +38,7 @@
 
 @register(User)
 class UserModelAdmin(PonyORMModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")

examples/fastapi_sqlalchemy/example.py

@@ -36,6 +36,7 @@
 
 @register(User, sqlalchemy_sessionmaker=sqlalchemy_sessionmaker)
 class UserModelAdmin(SqlAlchemyModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")

examples/fastapi_tortoiseorm/example.py

@@ -57,6 +57,7 @@ async def upload_file(
 
 @register(User)
 class UserModelAdmin(TortoiseModelAdmin):
+    menu_section = "Users"
     list_display = ("id", "username", "is_superuser")
     list_display_links = ("id", "username")
     list_filter = ("id", "username", "is_superuser")

fastadmin/models/base.py

@@ -666,6 +666,10 @@ class InlineModelAdmin(BaseModelAdmin):
 class ModelAdmin(BaseModelAdmin):
     """This class is used to create admin model class."""
 
+    # Optional section name for grouping models in the left menu.
+    # Example of usage: menu_section = "Users"
+    menu_section: str | None = None
+
     # Normally, objects have three save options: “Save”, “Save and continue editing”, and “Save and add another”.
     # If save_as is True, “Save and add another” will be replaced
     # by a “Save as new” button that creates a new object (with a new ID) rather than updating the existing object.

fastadmin/models/decorators.py

@@ -69,6 +69,7 @@ def widget_action(
     width: (
         tp.Literal[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24] | None
     ) = None,  # width in 1-24 grid system
+    max_height: int | None = None,
 ):
     """Conveniently add attributes to a widget action function:
 
@@ -132,6 +133,7 @@ def decorator(func):
         wrapped.tab = tab
         wrapped.title = title
         wrapped.width = width
+        wrapped.max_height = max_height
         if description is not None:
             wrapped.short_description = description
         return wrapped

fastadmin/models/helpers.py

@@ -245,6 +245,7 @@ async def generate_models_schema(
                     title=widget_action_function.title,
                     tab=widget_action_function.tab,
                     width=widget_action_function.width,
+                    max_height=getattr(widget_action_function, "max_height", None),
                     description=getattr(widget_action_function, "short_description", None),
                     widget_action_type=widget_action_function.widget_action_type,
                     widget_action_props=widget_action_function.widget_action_props,
@@ -275,6 +276,7 @@ async def generate_models_schema(
                     show_full_result_count=admin_model_obj.show_full_result_count,
                     verbose_name=admin_model_obj.verbose_name,
                     verbose_name_plural=admin_model_obj.verbose_name_plural,
+                    menu_section=getattr(admin_model_obj, "menu_section", None),
                     # specific model fields
                     fieldsets=admin_model_obj.fieldsets,
                     save_on_top=admin_model_obj.save_on_top,

fastadmin/models/schemas.py

@@ -124,6 +124,7 @@ class ModelWidgetAction:
     description: str | None
     tab: str
     width: int | None
+    max_height: int | None
     widget_action_type: WidgetActionType
     widget_action_props: WidgetActionChartProps | WidgetActionProps | None = None
     widget_action_filters: list[WidgetActionFilter] | None = None
@@ -211,6 +212,7 @@ class InlineModelSchema(BaseModelSchema):
 class ModelSchema(BaseModelSchema):
     """Model schema"""
 
+    menu_section: str | None
     fieldsets: Sequence[tuple[str | None, dict[str, Sequence[str]]]] | None
     save_on_top: bool | None
     save_as: bool | None