github-starred/open-webui
2
0
Fork 0
mirror of https://github.com/open-webui/open-webui.git synced 2026-05-07 19:38:46 -05:00
Code Issues 1.3k Packages Projects Releases 126 Wiki Activity

[GH-ISSUE #20762] issue: "Navigate to the Knowledge section" is confusing documentation #34810

New Issue
Closed
opened 2026-04-25 08:59:34 -05:00 by GiteaMirror · 3 comments
GiteaMirror commented 2026-04-25 08:59:34 -05:00
Owner
Copy Link

Originally created by @robogeek on GitHub (Jan 17, 2026).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/20762

Check Existing Issues

  • I have searched for any existing and/or related issues.
  • I have searched for any existing and/or related discussions.
  • I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!).
  • I am using the latest version of Open WebUI.

Installation Method

Docker

Open WebUI Version

0.7.2

Ollama Version (if applicable)

No response

Operating System

Ubuntu 22.04

Browser (if applicable)

Chrome

Confirmation

  • I have read and followed all instructions in README.md.
  • I am using the latest version of both Open WebUI and Ollama.
  • I have included the browser console logs.
  • I have included the Docker container logs.
  • I have provided every relevant configuration, setting, and environment variable used in my setup.
  • I have clearly listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc).
  • I have documented step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation. My steps:
  • Start with the initial platform/version/OS and dependencies used,
  • Specify exact install/launch/configure commands,
  • List URLs visited, user input (incl. example values/emails/passwords if needed),
  • Describe all options and toggles enabled or changed,
  • Include any files or environmental changes,
  • Identify the expected and actual result at each stage,
  • Ensure any reasonably skilled user can follow and hit the same issue.

Expected Behavior

I want to have files added to a Folder to augment the responses by the LLM.

The documentation describes "Knowldge" and a "Knowledge Base" and while those terms are vague, it seems to mean "knowledge" is an uploaded document, etc.

The documentation (https://docs.openwebui.com/features/workspace/knowledge) says

  • "The Knowledge section is a storage area"
  • Reference knowledge by prefixing a # character
  • "Navigate to the Knowledge Section"

But, I searched and searched and did not find a Knowledge section.

I expected there to be a clear description of how to find this section.

Actual Behavior

As I said, the actual behavior was a long search looking for this.

I even joined the Discord server and asked a question (https://discord.com/channels/1170866489302188073/1462073022155591852) but the question bot didn't really have an answer.

Steps to Reproduce

Look for The Knowedge Section and get confused.

Logs & Screenshots

n/a

Additional Information

I have eventually found the knowledge section.

In my opinion, I expected Knowledge to be in the left-hand sidebar. Instead it was hidden in the Workspace area.

The purpose of the Workspace area is rather mysterious at the moment. The default screen there talks about generating new Models or something, and since that's not of interest to me, I skipped past it.

I eventually noticed greyed out words one of which is Knowledge. That turned out to be the elusive Knowledge Area.

I think the solution is, in the documentation, to explicitly say "Workspace -> Knowledge".

The Discord question bot, in its answer, does say "Workspace -> Knowledge" which is what prompted me to look more closely in that area of the UI.

Originally created by @robogeek on GitHub (Jan 17, 2026). Original GitHub issue: https://github.com/open-webui/open-webui/issues/20762 ### Check Existing Issues - [x] I have searched for any existing and/or related issues. - [x] I have searched for any existing and/or related discussions. - [x] I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!). - [x] I am using the latest version of Open WebUI. ### Installation Method Docker ### Open WebUI Version 0.7.2 ### Ollama Version (if applicable) _No response_ ### Operating System Ubuntu 22.04 ### Browser (if applicable) Chrome ### Confirmation - [x] I have read and followed all instructions in `README.md`. - [x] I am using the latest version of **both** Open WebUI and Ollama. - [x] I have included the browser console logs. - [x] I have included the Docker container logs. - [x] I have **provided every relevant configuration, setting, and environment variable used in my setup.** - [x] I have clearly **listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup** (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc). - [x] I have documented **step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation**. My steps: - Start with the initial platform/version/OS and dependencies used, - Specify exact install/launch/configure commands, - List URLs visited, user input (incl. example values/emails/passwords if needed), - Describe all options and toggles enabled or changed, - Include any files or environmental changes, - Identify the expected and actual result at each stage, - Ensure any reasonably skilled user can follow and hit the same issue. ### Expected Behavior I want to have files added to a Folder to augment the responses by the LLM. The documentation describes "Knowldge" and a "Knowledge Base" and while those terms are vague, it seems to mean "knowledge" is an uploaded document, etc. The documentation (https://docs.openwebui.com/features/workspace/knowledge) says * "_The Knowledge section is a storage area_" * Reference knowledge by prefixing a `#` character * "_Navigate to the Knowledge Section_" But, I searched and searched and did not find a _Knowledge_ section. I expected there to be a clear description of how to find this section. ### Actual Behavior As I said, the actual behavior was a long search looking for this. I even joined the Discord server and asked a question (https://discord.com/channels/1170866489302188073/1462073022155591852) but the question bot didn't really have an answer. ### Steps to Reproduce Look for The Knowedge Section and get confused. ### Logs & Screenshots n/a ### Additional Information I have eventually found the knowledge section. In my opinion, I expected Knowledge to be in the left-hand sidebar. Instead it was hidden in the Workspace area. The purpose of the Workspace area is rather mysterious at the moment. The default screen there talks about generating new Models or something, and since that's not of interest to me, I skipped past it. I eventually noticed greyed out words one of which is Knowledge. That turned out to be the elusive Knowledge Area. I think the solution is, in the documentation, to explicitly say "Workspace -> Knowledge". The Discord question bot, in its answer, does say "Workspace -> Knowledge" which is what prompted me to look more closely in that area of the UI.
GiteaMirror added the bug label 2026-04-25 08:59:34 -05:00
GiteaMirror commented 2026-04-25 08:59:36 -05:00
Author
Owner
Copy Link

@owui-terminator[bot] commented on GitHub (Jan 17, 2026):

🔍 Similar Issues Found

I found some existing issues that might be related to this one. Please check if any of these are duplicates or contain helpful solutions:

  1. #20703 issue: Some Knowledge Bases dont work(?)
    by Nels2 • Jan 15, 2026 • bug

  2. #19752 issue: minor UI Bug: knowledge sharing
    by mahenning • Dec 04, 2025 • bug, confirmed issue

  3. #20730 issue: API to knowledge doesn't list files
    by sigi77 • Jan 16, 2026 • bug

  4. #20632 issue: Inconsistent behavior when editing section breaks.
    by jdwx • Jan 13, 2026 • bug

  5. #20236 issue: Select knowledge within Folders
    by liucoj • Dec 29, 2025 • bug

Show 5 more related issues

  1. #20335 issue: Display Issue with Knowledge Database Selection in OpenWebUI 0.6.43
    by zunami • Jan 02, 2026 • bug

  2. #19987 issue: There is a lack of visual consistency between the home page and the chat interface.
    by i-iooi-i • Dec 16, 2025 • bug

  3. #18159 issue: Issue with using a tool call and knolwedge documents.
    by rahepler2 • Oct 08, 2025 • bug

  4. #14861 issue: Slow knowledge listing
    by a3957273 • Jun 10, 2025 • bug

  5. #19491 issue: Referencing Knowledge in chats with '#' no longer shows which knowledge base does the file belong to
    by donatas-xyz • Nov 25, 2025 • bug

💡 Tips:

  • If this is a duplicate, please consider closing this issue and adding any additional details to the existing one
  • If you found a solution in any of these issues, please share it here to help others

This comment was generated automatically by a bot. Please react with a 👍 if this comment was helpful, or a 👎 if it was not.

<!-- gh-comment-id:3763764574 --> @owui-terminator[bot] commented on GitHub (Jan 17, 2026): 🔍 **Similar Issues Found** I found some existing issues that might be related to this one. Please check if any of these are duplicates or contain helpful solutions: 1. [#20703](https://github.com/open-webui/open-webui/issues/20703) **issue: Some Knowledge Bases dont work(?)** *by Nels2 • Jan 15, 2026 • `bug`* 2. [#19752](https://github.com/open-webui/open-webui/issues/19752) **issue: minor UI Bug: knowledge sharing** *by mahenning • Dec 04, 2025 • `bug`, `confirmed issue`* 3. [#20730](https://github.com/open-webui/open-webui/issues/20730) **issue: API to knowledge doesn't list files** *by sigi77 • Jan 16, 2026 • `bug`* 4. [#20632](https://github.com/open-webui/open-webui/issues/20632) **issue: Inconsistent behavior when editing section breaks.** *by jdwx • Jan 13, 2026 • `bug`* 5. [#20236](https://github.com/open-webui/open-webui/issues/20236) **issue: Select knowledge within Folders** *by liucoj • Dec 29, 2025 • `bug`* <details> <summary>Show 5 more related issues</summary> 6. [#20335](https://github.com/open-webui/open-webui/issues/20335) **issue: Display Issue with Knowledge Database Selection in OpenWebUI 0.6.43** *by zunami • Jan 02, 2026 • `bug`* 7. [#19987](https://github.com/open-webui/open-webui/issues/19987) **issue: There is a lack of visual consistency between the home page and the chat interface.** *by i-iooi-i • Dec 16, 2025 • `bug`* 8. [#18159](https://github.com/open-webui/open-webui/issues/18159) **issue: Issue with using a tool call and knolwedge documents.** *by rahepler2 • Oct 08, 2025 • `bug`* 9. [#14861](https://github.com/open-webui/open-webui/issues/14861) **issue: Slow knowledge listing** *by a3957273 • Jun 10, 2025 • `bug`* 10. [#19491](https://github.com/open-webui/open-webui/issues/19491) **issue: Referencing Knowledge in chats with '#' no longer shows which knowledge base does the file belong to** *by donatas-xyz • Nov 25, 2025 • `bug`* </details> --- 💡 **Tips:** - If this is a duplicate, please consider closing this issue and adding any additional details to the existing one - If you found a solution in any of these issues, please share it here to help others *This comment was generated automatically by a bot.* Please react with a 👍 if this comment was helpful, or a 👎 if it was not.
GiteaMirror commented 2026-04-25 08:59:37 -05:00
Author
Owner
Copy Link

@Classic298 commented on GitHub (Jan 17, 2026):

Please open docs related issues / feeback in the docs repository. not here. I will edit this page to make the content more clear. thankls

<!-- gh-comment-id:3763973390 --> @Classic298 commented on GitHub (Jan 17, 2026): Please open docs related issues / feeback in the docs repository. not here. I will edit this page to make the content more clear. thankls
GiteaMirror commented 2026-04-25 08:59:39 -05:00
Author
Owner
Copy Link

@Classic298 commented on GitHub (Jan 17, 2026):

https://github.com/open-webui/docs/pull/1017

updated

<!-- gh-comment-id:3763977301 --> @Classic298 commented on GitHub (Jan 17, 2026): https://github.com/open-webui/docs/pull/1017 updated
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
confirmed
confirmed issue
core
documentation
enhancement
good first issue
help wanted
non-core
pull-request
Mirrored from GitHub Pull Request
 python
question
testing wanted
No Label bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#34810
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?