Skip to content

📗 docs: Document fileConfig.officePreview for Large PowerPoint and Word Previews #790

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
TomasPalsson wants to merge 2 commits into
base: main
Choose a base branch
from
Open

📗 docs: Document fileConfig.officePreview for Large PowerPoint and Word Previews #790

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c3e19cf
📗 docs: Document fileConfig.officePreview for Large PowerPoint and Wo…
TomasPalsson Sep 29, 2026
3308b9d
Merge remote-tracking branch 'upstream/main' into docs/office-preview…
TomasPalsson Sep 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 33 additions & 1 deletion content/docs/configuration/librechat_yaml/object_structure/file_config.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ icon: FileCode

The `fileConfig` object allows you to configure file handling settings for the application, including size limits and MIME type restrictions. This section provides a detailed breakdown of the `fileConfig` object structure.

There are 13 main fields under `fileConfig`:
There are 14 main fields under `fileConfig`:

- `endpoints`
- `skills`
Expand All @@ -19,6 +19,7 @@ There are 13 main fields under `fileConfig`:
- `fileContextCharLimit`
- `defaultLLMDeliveryPath`
- `legacyFileUploadUX`
- `officePreview`
- `ocr`
- `text`
- `stt`
Expand Down Expand Up @@ -77,6 +78,9 @@ fileConfig:
fileContextSizeLimit: 128
fileContextCharLimit: 1000000
legacyFileUploadUX: false
officePreview:
enabled: true
fileSizeLimit: 25
imageGeneration:
percentage: 100
px: 1024
Expand Down Expand Up @@ -259,6 +263,34 @@ fileConfig:
legacyFileUploadUX: true
```

## officePreview

<OptionTable
options={[
['officePreview', 'Object', 'Settings for previewing large PowerPoint (.pptx) and Word (.docx) files created by code execution.', 'Controls whether large decks and documents open as the real document in the side panel, and up to what size.'],
]}
/>

**Description:** Files up to 350 KB are always previewed as before. A larger `.pptx` or `.docx` output is stored as a small preview page, and the viewer's browser loads the file's own bytes from file storage when the preview opens. Files above the limit show that they are too large to preview; they can still be downloaded.

`officePreview` supports the following parameters:

- `enabled` (Boolean)
- Turns large-file previews on or off.
- **Default:** `true`
- When `false`, files between 350 KB and 2 MB show a plain text outline, and larger files show that they are too large to preview.

- `fileSizeLimit` (Number)
- The largest file that can be previewed, specified in megabytes (MB). Must be `0` or more.
- **Default:** `25`

```yaml filename="fileConfig / officePreview"
fileConfig:
officePreview:
enabled: true
fileSizeLimit: 25
```

## ocr

<OptionTable
Expand Down