[PR #601] [MERGED] feat(docs): Enhance Filter Function docs with Valves dropdown UI #671

New issue

Closed

opened 2026-10-18 14:13:49 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:13:49 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/601
Author: @silentoplayz
Created: 7/1/2025
Status: ✅ Merged
Merged: 7/4/2025
Merged by: @tjbck

Base: main ← Head: enum-filter-docs-update

📝 Commits (1)

2a84b8f feat(docs): Enhance Filter Function docs with Valves dropdown UI

📊 Changes

1 file changed (+85 additions, -0 deletions)

View changed files

📝 docs/features/plugin/functions/filter.mdx (+85 -0)

📄 Description

Changelog Entry

Description

Updated the Filter Function documentation page to provide clearer guidance on creating interactive user interface elements, specifically dropdown menus, for filter configuration options (Valves), improveing developer understanding and filter usability.

Added

A new sub-section within the Valves explanation detailing the use of json_schema_extra with enum for Pydantic Field definitions to create dropdown menus in the Open WebUI interface.
An example code snippet demonstrating how to implement a dropdown for a Valves option using json_schema_extra={"enum": [...]}.

Changed

Expanded the "Key Components Explained" section, specifically the "Valves" part, to include the new information on UI dropdowns.

Additional Information

This update provides developers with clear instructions and an example on how to leverage Pydantic's Field and json_schema_extra to create interactive dropdowns for filter configurations (Valves). This enhances the user experience for filters by making settings more intuitive and less error-prone, allowing users to select from predefined options instead of manually typing values.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/601 **Author:** [@silentoplayz](https://github.com/silentoplayz) **Created:** 7/1/2025 **Status:** ✅ Merged **Merged:** 7/4/2025 **Merged by:** [@tjbck](https://github.com/tjbck) **Base:** `main` ← **Head:** `enum-filter-docs-update` --- ### 📝 Commits (1) - [`2a84b8f`](https://github.com/open-webui/docs/commit/2a84b8fbd7719faac34ab7d5518e9f17b652e26d) feat(docs): Enhance Filter Function docs with Valves dropdown UI ### 📊 Changes **1 file changed** (+85 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/features/plugin/functions/filter.mdx` (+85 -0) </details> ### 📄 Description # Changelog Entry ### Description - Updated the Filter Function documentation page to provide clearer guidance on creating interactive user interface elements, specifically dropdown menus, for filter configuration options (Valves), improveing developer understanding and filter usability. ### Added - A new sub-section within the `Valves` explanation detailing the use of `json_schema_extra` with `enum` for Pydantic `Field` definitions to create dropdown menus in the Open WebUI interface. - An example code snippet demonstrating how to implement a dropdown for a `Valves` option using `json_schema_extra={"enum": [...]}`. ### Changed - Expanded the "Key Components Explained" section, specifically the "Valves" part, to include the new information on UI dropdowns. ### Additional Information - This update provides developers with clear instructions and an example on how to leverage Pydantic's `Field` and `json_schema_extra` to create interactive dropdowns for filter configurations (Valves). This enhances the user experience for filters by making settings more intuitive and less error-prone, allowing users to select from predefined options instead of manually typing values. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:13:49 +00:00