Building Your BloomEducators

How to manage and organise your knowledge base

Once you have uploaded files, the Knowledge Base tab is where you keep them tidy. You can search, sort, rename, change a file’s access level, replace outdated versions, re-ingest files that processed incompletely, and bulk-delete sources you no longer need. Every change takes effect immediately for new conversations.

Before you start

You need:

  • The Configure Bloom permission. Space Owners, Bloom Managers, and Educators have it; students do not.
  • At least one ingested file in the saved-sources list.
  • A clear idea of which sources you want students to see. Default access is Hidden from Students, so files stay private until you change that.

Step 1: Find and sort sources

Open your Bloom, click the Knowledge Base tab, and scroll to the saved-sources grid. Above the grid you will see a search box (“Search sources...”) and a sort dropdown.

The sort dropdown offers six options:

  • Name (A-Z) and Name (Z-A)
  • Newest first and Oldest first (by upload date)
  • Access (least first) and Access (most first), ordered Hidden → Reference Only → View Only → Full Access

Each source card shows the filename, the file extension, the upload date, and a coloured access-level pill (amber for hidden, violet for reference, blue for view-only, emerald for full access). If your Bloom has more than 30 sources, the grid paginates and search runs on the server.

Step 2: Edit a file or change access

Click the three-dot menu on any source card and choose Edit. The Edit File dialog opens with two fields: Name of file and Access Level.

The four access levels and their effects:

LevelDescription (shown in the dialog)
Hidden from StudentsOnly Managers can see this file. Students and Educators will not see it anywhere.
Reference OnlyStudents and Educators cannot view or download this file directly, but the AI can reference its content to answer questions.
View OnlyStudents and Educators can view this file in the browser, but cannot download it.
Full AccessStudents and Educators can both view and download this file.

Step 3: Replace an outdated file

To swap in a new version of a document, upload a file with the same filename. Bloom detects the clash and opens the Overwrite warning so you can confirm. After you ingest, the new file replaces the old chunks and embeddings in the RAG index. There is no need to delete the previous version first.

If you want a clean slate instead, delete the old file from the three-dot menu, then upload the new one under any name.

Step 4: Re-ingest incomplete files

Sometimes a file ingests but only partially indexes (for example, a long PDF where some pages failed to extract). Bloom flags these with an amber warning under the filename:

To fix it, upload the same file again. Bloom recognises it as a duplicate, prompts you to overwrite, and runs a fresh ingestion that re-extracts text and rebuilds embeddings.

Step 5: Use bulk actions

Hover any source card to reveal a checkbox in place of the file icon, then tick the files you want to act on. A toolbar appears at the top of the grid showing {N} selected” with two buttons: Select All and Delete.

Clicking Delete opens a confirmation listing every filename. The dialog warns: “Are you sure you want to delete {N}sources? This action cannot be undone.” Confirm to remove the files from storage and the RAG index in one go.

Common issues

The AI is still quoting a file I deleted

Active conversations may briefly hold cached context from before the deletion. Start a new conversation and the deleted file will no longer appear in retrieval.

I see “Failed to delete {filename}” in a toast

One or more files could not be removed (usually a transient storage error). Bloom keeps the failed files in the list so you can retry. Wait a few seconds and try again, or refresh the page first.

“View Only” and “Full Access” options are missing

The file is a URL, DOCX, PPTX, or other non-PDF. Only PDFs render in the in-browser viewer, so other formats are limited to Hidden from Students or Reference Only. To enable view or download, convert the file to PDF and re-upload.

I cannot find a file using search

Search matches the filename, not the file’s contents. Make sure you are searching by the title exactly as it appears in the saved-sources grid. If you have more than 30 files, search runs against the server and may take up to 300 ms to debounce after you stop typing.

What’s next

On this page

Still stuck?

Send our team a message and we'll get back to you.