From 33dff7524d1b141ffef1803f4c52bf3546c82872 Mon Sep 17 00:00:00 2001
From: Matthew Daniell <matthewdaniell@Matthews-MacBook-Pro-2.local>
Date: Tue, 31 Mar 2026 13:30:29 +1030
Subject: [PATCH 1/2] docs: add clientImageResize minFileSizeKB option

Document the new minFileSizeKB setting for client-side image resizing
so docs match the behavior change in LibreChat.

Made-with: Cursor
---
 .../configuration/librechat_yaml/object_structure/config.mdx     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/content/docs/configuration/librechat_yaml/object_structure/config.mdx b/content/docs/configuration/librechat_yaml/object_structure/config.mdx
index 3bb79b4b0..212e91498 100644
--- a/content/docs/configuration/librechat_yaml/object_structure/config.mdx
+++ b/content/docs/configuration/librechat_yaml/object_structure/config.mdx
@@ -229,6 +229,7 @@ see: [Web Search Object Structure](/docs/configuration/librechat_yaml/object_str
 <OptionTable
   options={[
     ['enabled', 'Boolean', 'Enables or disables client-side image resizing functionality. Default: false.', 'enabled: true'],
+    ['minFileSizeKB', 'Number', 'Minimum file size threshold in KB for resizing. Files smaller than this value are not resized. Default: 200.', 'minFileSizeKB: 200'],
     ['maxWidth', 'Number', 'Maximum width in pixels for resized images. Images wider than this will be resized. Default: 1920.', 'maxWidth: 1024'],
     ['maxHeight', 'Number', 'Maximum height in pixels for resized images. Images taller than this will be resized. Default: 1080.', 'maxHeight: 768'],
     ['quality', 'Number', 'JPEG compression quality (0.1 to 1.0). Higher values mean better quality but larger file sizes. Default: 0.8.', 'quality: 0.9'],

From f4b10348c46779d3a0621279fb541f72ea1998e5 Mon Sep 17 00:00:00 2001
From: Matthew Daniell <matthewdaniell@Matthews-MacBook-Pro-2.local>
Date: Tue, 31 Mar 2026 14:15:21 +1030
Subject: [PATCH 2/2] docs: include minFileSizeKB in resize example notes

Align the clientImageResize example and notes with the new minFileSizeKB
behavior so the docs match the implementation PR.

Made-with: Cursor
---
 .../configuration/librechat_yaml/object_structure/config.mdx    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/content/docs/configuration/librechat_yaml/object_structure/config.mdx b/content/docs/configuration/librechat_yaml/object_structure/config.mdx
index 212e91498..0f6733569 100644
--- a/content/docs/configuration/librechat_yaml/object_structure/config.mdx
+++ b/content/docs/configuration/librechat_yaml/object_structure/config.mdx
@@ -253,6 +253,7 @@ When enabled, images that exceed the specified `maxWidth` or `maxHeight` dimensi
 fileConfig:
   clientImageResize:
     enabled: true
+    minFileSizeKB: 1024
     maxWidth: 1920
     maxHeight: 1080
     quality: 0.8
@@ -263,6 +264,7 @@ fileConfig:
 
 - Only applies to image files (JPEG, PNG, WebP, etc.)
 - Resizing occurs automatically when images exceed the specified dimensions
+- Files smaller than `minFileSizeKB` are skipped to avoid unnecessary processing
 - Original aspect ratio is preserved during resizing
 - The feature works with all supported image upload endpoints
 - Quality setting only applies to JPEG and WebP formats