[PR #1141] [CLOSED] docs: add file metadata fields documentation for knowledge base #1138

New issue

Closed

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

bsakaguchi commented

2026-10-18 14:17:25 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1141
Author: @IllimarR
Created: 3/16/2026
Status: ❌ Closed

Base: dev ← Head: feat/file-metadata-fields

📝 Commits (1)

d7e02af docs: add file metadata fields documentation

📊 Changes

2 files changed (+206 additions, -0 deletions)

View changed files

➕ docs/features/ai-knowledge/file-metadata-fields.md (+198 -0)
📝 docs/features/ai-knowledge/knowledge.md (+8 -0)

📄 Description

Summary

Documentation for the new config-driven file metadata support in knowledge bases, accompanying the feature PR in the main repository.

New page: docs/features/ai-knowledge/file-metadata-fields.md
Updated: docs/features/ai-knowledge/knowledge.md with a section linking to the new page

What's documented

FILE_METADATA_FIELDS environment variable and admin API configuration
Field definition properties (key, type, embed, context, filter)
API endpoints: get/update/batch-update file metadata, field discovery
How metadata flows through the RAG pipeline (vector DB, BM25, LLM source tags)
Setting metadata during file upload
Adding custom fields at runtime

Feature PR (dev repo): https://github.com/open-webui/open-webui/pull/22737

_{🔄 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/1141 **Author:** [@IllimarR](https://github.com/IllimarR) **Created:** 3/16/2026 **Status:** ❌ Closed **Base:** `dev` ← **Head:** `feat/file-metadata-fields` --- ### 📝 Commits (1) - [`d7e02af`](https://github.com/open-webui/docs/commit/d7e02af803e66a00f158f590ab835d086dd108c6) docs: add file metadata fields documentation ### 📊 Changes **2 files changed** (+206 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `docs/features/ai-knowledge/file-metadata-fields.md` (+198 -0) 📝 `docs/features/ai-knowledge/knowledge.md` (+8 -0) </details> ### 📄 Description ## Summary Documentation for the new config-driven file metadata support in knowledge bases, accompanying the feature PR in the main repository. - New page: `docs/features/ai-knowledge/file-metadata-fields.md` - Updated: `docs/features/ai-knowledge/knowledge.md` with a section linking to the new page ### What's documented - `FILE_METADATA_FIELDS` environment variable and admin API configuration - Field definition properties (`key`, `type`, `embed`, `context`, `filter`) - API endpoints: get/update/batch-update file metadata, field discovery - How metadata flows through the RAG pipeline (vector DB, BM25, LLM source tags) - Setting metadata during file upload - Adding custom fields at runtime ### Related - Feature PR (dev repo): https://github.com/open-webui/open-webui/pull/22737 --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:17:25 +00:00