[DOCS]:How to perform paragraph-level metadata tagging?

[liutong-eeo]

Type of Documentation Change

Other

Documentation Page URL or Path

https://docs.dify.ai/zh-hans/guides/knowledge-base/metadata

Current Content

We are already using document-level metadata, but our requirement is to perform paragraph-level filtering when retrieving segments. I wonder if Dify has this functionality.

Suggested Changes

no

Reason for Change

No response

Code of Conduct

• I agree to follow Dify's documentation contribution guidelines
• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report, otherwise it will be closed.
• 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：）
• Please do not modify this template :) and fill in all the required fields.

[dosubot]

Hi @liutong-eeo! I'm Dosu and I’m helping the dify-docs team.

Dify does not currently support paragraph-level (segment-level) metadata tagging or filtering—metadata can only be defined and filtered at the document level. While the codebase structures allow for metadata to be attached to individual chunks or segments, there is no built-in way to filter or retrieve segments based on their own metadata during search or retrieval operations. This limitation is confirmed in both the documentation and open feature requests from other users who want more granular filtering capabilities at the segment level (reference).

If you need fine-grained filtering, a common workaround is to split your content into smaller documents, each with its own metadata, or organize your knowledge base by metadata type. True paragraph-level metadata filtering would require architectural changes and is not available out of the box.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}