Target branch: Verify that the pull request targets the dev branch. Not targeting the dev branch will lead to immediate closure of the PR.
Description: Provide a concise description of the changes made in this pull request down below.
Changelog: Ensure a changelog entry following the format of Keep a Changelog is added at the bottom of the PR description.
Documentation: If necessary, update relevant documentation Open WebUI Docs like environment variables, the tutorials, or other documentation sources.
Dependencies: Are there any new dependencies? Have you updated the dependency versions in the documentation?
Testing: Perform manual tests to verify the implemented fix/feature works as intended AND does not break any other functionality. Take this as an opportunity to make screenshots of the feature/fix and include it in the PR description.
Agentic AI Code: Confirm this Pull Request is not written by any AI Agent or has at least gone through additional human review AND manual testing. If any AI Agent is the co-author of this PR, it may lead to immediate closure of the PR.
Code review: Have you performed a self-review of your code, addressing any coding standard issues and ensuring adherence to the project's coding standards?
Title Prefix: To clearly categorize this pull request, prefix the pull request title using one of the following:
feat: Introduces a new feature or enhancement to the codebase
Changelog Entry
Description
This PR implements admin control for interface settings with global defaults, permission-based access control, and user reset functionality. Admins can now configure default interface settings (chat bubble, wide screen, RTL, etc.) that apply to all users, while maintaining granular control over which user groups can modify these settings.
Key Features:
Global admin-configurable interface defaults
Permission-based hiding of Interface Settings tab (ui.interface_settings) on a group level
Three-tier settings fallback: User custom → Admin default → System default
Reset button for users to revert ALL USERS custom interface settings to admin-configured defaults
Backward compatible with existing installations, no breaking changes
Architectural Decisions:
Interface settings are global because adding these on a group level IS NOT POSSIBLE TECHNICALLY. If a user is part of two groups with conflicting interface settings, which interface setting takes priority? These are not permissions which are additive.
Permission is group-level to allow admins to lock down the interface for specific user groups (e.g., restrict customization for external users while allowing internal users full control)
This hybrid approach balances user experience with administrative control
Contributor License Agreement
By submitting this pull request, I confirm that I have read and fully agree to the Contributor License Agreement (CLA), and I am providing my contributions under its terms.
Note
Deleting the CLA section will lead to immediate closure of your PR and it will not be merged in.
🔄 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/open-webui/pull/19954
**Author:** [@Classic298](https://github.com/Classic298)
**Created:** 12/14/2025
**Status:** ❌ Closed
**Base:** `dev` ← **Head:** `admin-interface`
---
### 📝 Commits (10+)
- [`bcb42df`](https://github.com/open-webui/open-webui/commit/bcb42df0bd77297a130a2572137d1b2c23ea7f0e) Admin interface settings (#104)
- [`651a02f`](https://github.com/open-webui/open-webui/commit/651a02f7a8c49fd3cd58210540dc4e79ffe49b34) Update Interface.svelte
- [`851893d`](https://github.com/open-webui/open-webui/commit/851893d962f93250a3ac982de66087a08bb6ec98) Update Interface.svelte
- [`9fbae88`](https://github.com/open-webui/open-webui/commit/9fbae88b198faaac0c7fbe8021fa2b51f328ece9) Update text-scale.ts
- [`dc7d79c`](https://github.com/open-webui/open-webui/commit/dc7d79c9c6e1656846f478e2e01ecebdc580e5d9) Update text-scale.ts
- [`69024ca`](https://github.com/open-webui/open-webui/commit/69024cace032f7fe96ff414af17d61562ff386d8) Update users.py
- [`1d03fc6`](https://github.com/open-webui/open-webui/commit/1d03fc62b6e51e49f48d0a9d5ac95bcb58cffdf2) Update users.py
- [`db88d4d`](https://github.com/open-webui/open-webui/commit/db88d4d7867712b9e18de099feff98489f491200) Update configs.py
- [`a28caa0`](https://github.com/open-webui/open-webui/commit/a28caa0a0e46c1e2de8e521c8293d3cac1627ac3) Update InterfaceDefaultsModal.svelte
- [`c35f676`](https://github.com/open-webui/open-webui/commit/c35f676f7c5a251921af31dc8d60e2f048552393) Update Interface.svelte
### 📊 Changes
**14 files changed** (+1032 additions, -290 deletions)
<details>
<summary>View changed files</summary>
📝 `backend/open_webui/models/groups.py` (+2 -1)
📝 `backend/open_webui/routers/configs.py` (+108 -1)
📝 `backend/open_webui/routers/users.py` (+96 -0)
📝 `src/lib/apis/configs/index.ts` (+55 -0)
📝 `src/lib/apis/users/index.ts` (+27 -0)
📝 `src/lib/components/admin/Settings/Interface.svelte` (+147 -0)
➕ `src/lib/components/admin/Settings/Interface/InterfaceDefaultsModal.svelte` (+212 -0)
📝 `src/lib/components/admin/Users/Groups/EditGroupModal.svelte` (+15 -61)
📝 `src/lib/components/admin/Users/Groups/Permissions.svelte` (+27 -62)
📝 `src/lib/components/chat/Settings/Interface.svelte` (+196 -161)
📝 `src/lib/components/chat/SettingsModal.svelte` (+9 -0)
➕ `src/lib/constants/permissions.ts` (+60 -0)
📝 `src/lib/utils/index.ts` (+50 -0)
📝 `src/routes/(app)/+layout.svelte` (+28 -4)
</details>
### 📄 Description
- [X] **Target branch:** Verify that the pull request targets the `dev` branch. **Not targeting the `dev` branch will lead to immediate closure of the PR.**
- [X] **Description:** Provide a concise description of the changes made in this pull request down below.
- [X] **Changelog:** Ensure a changelog entry following the format of [Keep a Changelog](https://keepachangelog.com/) is added at the bottom of the PR description.
- [X] **Documentation:** If necessary, update relevant documentation [Open WebUI Docs](https://github.com/open-webui/docs) like environment variables, the tutorials, or other documentation sources.
- [X] **Dependencies:** Are there any new dependencies? Have you updated the dependency versions in the documentation?
- [X] **Testing:** Perform manual tests to **verify the implemented fix/feature works as intended AND does not break any other functionality**. Take this as an opportunity to **make screenshots of the feature/fix and include it in the PR description**.
- [X] **Agentic AI Code:** Confirm this Pull Request is **not written by any AI Agent** or has at least **gone through additional human review AND manual testing**. If any AI Agent is the co-author of this PR, it may lead to immediate closure of the PR.
- [X] **Code review:** Have you performed a self-review of your code, addressing any coding standard issues and ensuring adherence to the project's coding standards?
- [X] **Title Prefix:** To clearly categorize this pull request, prefix the pull request title using one of the following:
- **feat**: Introduces a new feature or enhancement to the codebase
# Changelog Entry
### Description
This PR implements admin control for interface settings with global defaults, permission-based access control, and user reset functionality. Admins can now configure default interface settings (chat bubble, wide screen, RTL, etc.) that apply to all users, while maintaining granular control over which user groups can modify these settings.
Key Features:
- Global admin-configurable interface defaults
- Permission-based hiding of Interface Settings tab (ui.interface_settings) on a group level
- Three-tier settings fallback: User custom → Admin default → System default
- Reset button for users to revert ALL USERS custom interface settings to admin-configured defaults
- Backward compatible with existing installations, no breaking changes
Architectural Decisions:
- Interface settings are global because adding these on a group level IS NOT POSSIBLE TECHNICALLY. If a user is part of two groups with conflicting interface settings, which interface setting takes priority? These are not permissions which are additive.
- Permission is group-level to allow admins to lock down the interface for specific user groups (e.g., restrict customization for external users while allowing internal users full control)
- This hybrid approach balances user experience with administrative control
### Contributor License Agreement
By submitting this pull request, I confirm that I have read and fully agree to the [Contributor License Agreement (CLA)](https://github.com/open-webui/open-webui/blob/main/CONTRIBUTOR_LICENSE_AGREEMENT), and I am providing my contributions under its terms.
> [!NOTE]
> Deleting the CLA section will lead to immediate closure of your PR and it will not be merged in.
---
<sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
📋 Pull Request Information
Original PR: https://github.com/open-webui/open-webui/pull/19954
Author: @Classic298
Created: 12/14/2025
Status: ❌ Closed
Base:
dev← Head:admin-interface📝 Commits (10+)
bcb42dfAdmin interface settings (#104)651a02fUpdate Interface.svelte851893dUpdate Interface.svelte9fbae88Update text-scale.tsdc7d79cUpdate text-scale.ts69024caUpdate users.py1d03fc6Update users.pydb88d4dUpdate configs.pya28caa0Update InterfaceDefaultsModal.sveltec35f676Update Interface.svelte📊 Changes
14 files changed (+1032 additions, -290 deletions)
View changed files
📝
backend/open_webui/models/groups.py(+2 -1)📝
backend/open_webui/routers/configs.py(+108 -1)📝
backend/open_webui/routers/users.py(+96 -0)📝
src/lib/apis/configs/index.ts(+55 -0)📝
src/lib/apis/users/index.ts(+27 -0)📝
src/lib/components/admin/Settings/Interface.svelte(+147 -0)➕
src/lib/components/admin/Settings/Interface/InterfaceDefaultsModal.svelte(+212 -0)📝
src/lib/components/admin/Users/Groups/EditGroupModal.svelte(+15 -61)📝
src/lib/components/admin/Users/Groups/Permissions.svelte(+27 -62)📝
src/lib/components/chat/Settings/Interface.svelte(+196 -161)📝
src/lib/components/chat/SettingsModal.svelte(+9 -0)➕
src/lib/constants/permissions.ts(+60 -0)📝
src/lib/utils/index.ts(+50 -0)📝
src/routes/(app)/+layout.svelte(+28 -4)📄 Description
devbranch. Not targeting thedevbranch will lead to immediate closure of the PR.Changelog Entry
Description
This PR implements admin control for interface settings with global defaults, permission-based access control, and user reset functionality. Admins can now configure default interface settings (chat bubble, wide screen, RTL, etc.) that apply to all users, while maintaining granular control over which user groups can modify these settings.
Key Features:
Architectural Decisions:
Contributor License Agreement
By submitting this pull request, I confirm that I have read and fully agree to the Contributor License Agreement (CLA), and I am providing my contributions under its terms.
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.