feat: Global Background Image Setting #5436

New Issue

2025-11-11T16:21:00-06:00

GiteaMirror commented

2025-11-11 16:21:00 -06:00

Originally created by @silentoplayz on GitHub (Jun 4, 2025).

Check Existing Issues

I have searched the existing issues and discussions.

Problem Description

Currently, the Chat Background Image setting allows for personalizing the background only within the chat interface. This means other core sections of the application, such as the Workspace (Models, Knowledge, Prompts, Tools, Functions) and the Admin Panel (Dashboard, Settings), remain with the default background.

Users seeking a consistent, personalized visual experience across the entire Open WebUI application are unable to achieve this with the existing, chat-specific setting.

Desired Solution you'd like

I propose introducing a new user-level interface setting, distinct from Chat Background Image, provisionally named Global Background Image.

This new setting would allow users to select an image that serves as the background for all major sections of the Open WebUI application with a tint (similar to that as seen with the use of a chat background image applied), including:

Workspace pages: Models, Knowledge Base, Prompts, Tools, and Functions.
Admin Panel pages: Dashboard and Settings.

The existing Chat Background Image setting would remain unchanged, continuing to provide specific background customization for the chat interface. If both Global Background Image and Chat Background Image are set, the Chat Background Image would take precedence and override the global setting only within the chat views, allowing for granular control.

Alternatives Considered

An alternative considered was to rename the existing Chat Background Image setting and expand its functionality to cover the entire UI. However, this approach has two drawbacks:

It would remove the specific customization option for just the chat interface, which some users might prefer to keep separate.
Renaming an existing setting might be confusing for users familiar with the current nomenclature and could potentially lead to unexpected behavior if not handled carefully during migration.

Another alternative concept that was considered was setting chat backgrounds at a model level (i.e., having custom backgrounds per model). However, this idea presents complexities, especially in scenarios where multiple models are used concurrently within a single chat session. If two or more models, each with their own assigned background, are responding simultaneously, it becomes ambiguous which background should be displayed, potentially leading to a confusing or flickering user experience.

Introducing a separate Global Background Image setting provides maximum flexibility, allowing users to customize their entire experience, while retaining the option for chat-specific backgrounds.

Additional Context

This enhancement would significantly boost the personalization capabilities of Open WebUI, allowing users to create a more consistent and aesthetically pleasing environment across the entire application. It leverages existing functionality (background image display) and extends it logically to other parts of the UI, improving the overall user experience.

I deleted the original feature request message of mine from Discord before thinking to take this screen capture for the issue post.

Originally created by @silentoplayz on GitHub (Jun 4, 2025). ### Check Existing Issues - [x] I have searched the existing issues and discussions. ### Problem Description Currently, the `Chat Background Image` setting allows for personalizing the background *only* within the chat interface. This means other core sections of the application, such as the Workspace (Models, Knowledge, Prompts, Tools, Functions) and the Admin Panel (Dashboard, Settings), remain with the default background. Users seeking a consistent, personalized visual experience across the entire Open WebUI application are unable to achieve this with the existing, chat-specific setting. ### Desired Solution you'd like I propose introducing a **new** user-level interface setting, distinct from `Chat Background Image`, provisionally named `Global Background Image`. This new setting would allow users to select an image that serves as the background for all major sections of the Open WebUI application with a tint (similar to that as seen with the use of a chat background image applied), including: * **Workspace pages:** Models, Knowledge Base, Prompts, Tools, and Functions. * **Admin Panel pages:** Dashboard and Settings. The existing `Chat Background Image` setting would remain unchanged, continuing to provide specific background customization for the chat interface. If both `Global Background Image` and `Chat Background Image` are set, the `Chat Background Image` would take precedence and override the global setting *only* within the chat views, allowing for granular control. ### Alternatives Considered An alternative considered was to rename the existing `Chat Background Image` setting and expand its functionality to cover the entire UI. However, this approach has two drawbacks: 1. It would remove the specific customization option for just the chat interface, which some users might prefer to keep separate. 2. Renaming an existing setting might be confusing for users familiar with the current nomenclature and could potentially lead to unexpected behavior if not handled carefully during migration. Another alternative concept that was considered was setting chat backgrounds at a **model level** (i.e., having custom backgrounds per model). However, this idea presents complexities, especially in scenarios where multiple models are used concurrently within a single chat session. If two or more models, each with their own assigned background, are responding simultaneously, it becomes ambiguous which background should be displayed, potentially leading to a confusing or flickering user experience. Introducing a separate `Global Background Image` setting provides maximum flexibility, allowing users to customize their entire experience, while retaining the option for chat-specific backgrounds. ### Additional Context This enhancement would significantly boost the personalization capabilities of Open WebUI, allowing users to create a more consistent and aesthetically pleasing environment across the entire application. It leverages existing functionality (background image display) and extends it logically to other parts of the UI, improving the overall user experience. **I deleted the original feature request message of mine from Discord before thinking to take this screen capture for the issue post.** ![Image](https://github.com/user-attachments/assets/0c6de39b-0df5-444a-a900-347e71b9b27e)

GiteaMirror added the enhancement label 2025-11-11 16:21:00 -06:00

GiteaMirror referenced this issue

2025-11-11 17:57:47 -06:00

[PR #5436] [MERGED] fix: model transparent icons #8484

GiteaMirror referenced this issue

2026-04-20 03:39:26 -05:00

[PR #5436] [MERGED] fix: model transparent icons #21688

GiteaMirror referenced this issue

2026-04-25 10:51:09 -05:00

[PR #5436] [MERGED] fix: model transparent icons #37318

GiteaMirror referenced this issue

2026-04-29 18:55:03 -05:00