Open WebUI knowledge bases turn reusable documents into searchable chat context for teams, projects, and support runbooks. Creating one is useful when the same files should be available across many conversations instead of being uploaded into one temporary chat.

The Knowledge area lives under Workspace. An embedding model indexes uploaded text for retrieval, while a chat model writes answers from the retrieved passages. A signed-in account with Knowledge access and working chat and embedding models is required.

Collections start private to their owner, although instance administrators can still access the data. Uploaded documents remain stored on the instance, and retrieved passages are sent to the selected model provider. Document sensitivity and the provider's data policy determine what belongs in the collection.

Steps to create a knowledge base in Open WebUI:

  1. Open Workspace from the sidebar.
  2. Select the Knowledge tab.
  3. Click Create in the upper-right corner.
  4. Enter Support Escalation Handbook as the knowledge base name.
  5. Enter a description of the documents the collection will contain.
    Escalation hours and owner for support requests.

  6. Click Create Knowledge with Visibility left at Private.

    The new collection opens automatically. Private visibility does not grant access to other users or groups.

  7. Save the following text as support-note.txt.
    support-note.txt
    Open WebUI support escalation note
     
    Escalation window: weekdays 09:00-17:00 UTC.
    Escalation owner: Platform Support Team.
    Verification phrase: blue-sky-router.
  8. Open the Add Content plus menu beside Search Collection.
  9. Upload support-note.txt through Upload files.
  10. Confirm the uploaded row shows its file size instead of Uploading or Processing.

    A Failed indicator means the document is not ready for retrieval. Larger documents may take longer to extract and index.

  11. Open support-note.txt to inspect its extracted text.
  12. Start a New Chat from the sidebar.
  13. Select an available chat model from the message box's model selector.

    The selected model here is company-chat:latest. An embedding-only model cannot write the chat reply.

  14. Type # in the message box.
  15. Select Support Escalation Handbook under Collections.

    The collection appears above the message input. The default Focused Retrieval mode searches for relevant passages rather than sending the entire collection.

  16. Enter a question whose answer is in the uploaded note.
    According to Support Escalation Handbook, what are the escalation window, escalation owner, and verification phrase? Quote the values and cite the source.

  17. Send the message.
  18. Confirm the reply reports weekdays 09:00-17:00 UTC, Platform Support Team, and blue-sky-router.
  19. Expand the source list beneath the reply.

    Retrieved 1 source and the support-note.txt entry show which document supplied context for the answer.

  20. Open the cited support-note.txt to compare its text with the answer.
Share this guide