[PR #1283] [MERGED] Document `FILE_IMAGE_COMPRESSION_WIDTH` and `FILE_IMAGE_COMPRESSION_HEIGHT` #1264

New issue

Closed

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

bsakaguchi commented

2026-10-18 14:18:26 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1283
Author: @ThomasCle
Created: 6/4/2026
Status: ✅ Merged
Merged: 6/6/2026
Merged by: @Classic298

Base: main ← Head: docs/file-image-compression

📝 Commits (2)

f8d270f docs: added missing description for FILE_IMAGE_COMPRESSION_ variables.
5991659 Update env-configuration.mdx

📊 Changes

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

View changed files

📝 docs/reference/env-configuration.mdx (+20 -0)

📄 Description

Summary

Add missing documentation for the following environment variables in docs/reference/env-configuration.mdx:

FILE_IMAGE_COMPRESSION_WIDTH
FILE_IMAGE_COMPRESSION_HEIGHT

What this changes

Documents both variables as ConfigVar environment variables
Adds their default value (None)
Clarifies that they control client-side compression limits for chat-uploaded image files
Notes that non-image file uploads are not affected

Why

These variables exist in Open WebUI but were not documented in the environment variable reference. This PR fills that gap so users can understand what they do and when they apply.

Notes

This wording was checked against current upstream behavior:

the backend exposes these values through app config
the frontend uses them during chat image upload compression
aspect ratio is preserved during resizing

_{🔄 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/1283 **Author:** [@ThomasCle](https://github.com/ThomasCle) **Created:** 6/4/2026 **Status:** ✅ Merged **Merged:** 6/6/2026 **Merged by:** [@Classic298](https://github.com/Classic298) **Base:** `main` ← **Head:** `docs/file-image-compression` --- ### 📝 Commits (2) - [`f8d270f`](https://github.com/open-webui/docs/commit/f8d270fdec9c96fdc1568b6ac527c5def5bd3a0f) docs: added missing description for `FILE_IMAGE_COMPRESSION_` variables. - [`5991659`](https://github.com/open-webui/docs/commit/59916595fd73f8c381670d2af90f04a8110f9089) Update env-configuration.mdx ### 📊 Changes **1 file changed** (+20 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/reference/env-configuration.mdx` (+20 -0) </details> ### 📄 Description ## Summary Add missing documentation for the following environment variables in `docs/reference/env-configuration.mdx`: - `FILE_IMAGE_COMPRESSION_WIDTH` - `FILE_IMAGE_COMPRESSION_HEIGHT` ## What this changes - Documents both variables as `ConfigVar` environment variables - Adds their default value (`None`) - Clarifies that they control client-side compression limits for chat-uploaded image files - Notes that non-image file uploads are not affected ## Why These variables exist in Open WebUI but were not documented in the environment variable reference. This PR fills that gap so users can understand what they do and when they apply. ## Notes This wording was checked against current upstream behavior: - the backend exposes these values through app config - the frontend uses them during chat image upload compression - aspect ratio is preserved during resizing --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:18:26 +00:00