All chapters

Knowledge Base: upload and organize documents

What the Knowledge Base is

The Knowledge Base is your office's library of documents. Open it from the sidebar: Knowledge Base › Library. Everything in it is read and indexed so you can ask questions about it in Ask Acta. Everyone in the workspace sees the same library. There are no private documents: every member of the workspace can see every document in it.

There is one library. A document is in the Knowledge Base when it has a status in the library. Files you give to Translation, Anonymization or Smart Processing to work on join the Knowledge Base automatically and are indexed, so Ask Acta can answer from them too. This includes the originals you send to Anonymization, which stay view-only (see the Anonymization guide). What Acta makes (translations, anonymized copies, processing results, drafts), templates and a guideline's examples do not join the Knowledge Base on their own.

Upload documents

  1. Open Knowledge Base › Library and click Upload, or drag files onto the library.
  2. In the dialog, choose or drop your files. You can pick a Folder and, if the Clients & Cases module is on, a Case (both optional). The documents are filed in them.
  3. Wait for the upload to finish and keep the page open until it does.
  4. Each file then shows Processing while Acta reads and indexes it, and Ready when it is done. This takes a minute or two. You can leave the page; processing keeps going.

Tips:

  • Upload into the right folder or case straight away. It saves moving documents later.
  • Give files clear names (for example "Deed of sale Martin 2026-03.pdf"). You can rename them later.
  • Prefer the original PDF or Word file to a photo of it. Text from a file is more exact than text read from a picture.

Accepted files, up to 50 MB each and 20 files at a time:

  • PDF.
  • Word: .doc, .docx, .docm, .dotx, .odt, .rtf.
  • Text: .txt, .md, .markdown.
  • Spreadsheets: .xlsx, .xlsm, .xls, .ods, .csv.
  • Presentations: .pptx, .pptm, .ppt, .odp.
  • Web pages and emails: .html, .htm, .eml.
  • Photos and scans: .jpg, .jpeg, .png, .tif, .tiff, .webp, .bmp, .gif, .heic, .heif.

Other file types are skipped, and the dialog says how many files were skipped. If you choose more than 20 files, upload at most 20 at a time.

What Acta reads from each kind:

  • PDF: the text of each page. A page with little or no text (a scan) is read with text recognition. A PDF with even one scanned page is read this way as a whole.
  • Scans and photos are read with text recognition. A page scanned sideways or upside down is turned the right way before it is read. A TIFF with several frames is read frame by frame.
  • Word, OpenDocument and RTF files are read page by page, so answers can cite a page.
  • Presentations: one page per slide.
  • Spreadsheets and CSV files are read in blocks of 20 rows that repeat the header row. They have no pages.
  • Emails (.eml): the headers, the message and the attachments Acta can read.
  • Web pages: their text.

For each document Acta also writes a short summary, shown on the document's page.

What the statuses mean

  • Processing: Acta is reading and indexing the file. It can't be asked about yet.
  • Ready: the file is indexed. Ask Acta can use it, and its summary is on its page.
  • Failed: the file could not be read. The reason is written under its name.

Only Ready documents are used by Ask Acta.

How a document is read

Acta splits the text of each document into passages and indexes them. When you ask a question, it finds the passages that match and writes an answer that cites them. For that reason a document must be Ready before you can ask about it. Until then the page says "The summary and AI features unlock when processing finishes."

Why a file failed and how to fix it

A file shows Failed when its text can't be read. The reason is written under its name.

Common reasons and what to do:

  • Password-protected PDF or Office file: ask the sender for an unlocked copy and upload that.
  • A PDF or file that is damaged and can't be opened: get a fresh copy of the file.
  • No text could be read (a faint, blurred or empty scan): scan it again at a higher resolution, or upload the Word version.
  • A file type that can't be added to the Knowledge Base: use one of the accepted types above.
  • A problem on Acta's side or a timeout: open the row's ••• menu and choose Try again. The status goes back to Processing.

If the reason says the AI service has run out of credit, ask the workspace owner to add credit and then try again. If it says this month's AI allowance is used up, the work starts again on the 1st of next month.

To try again: open the ••• menu on the failed row and click Try again. You can also open the document's page, which shows "We couldn't read this file" with the reason, and go back to the library to retry.

If a document stays on Processing much longer than a few minutes, leave it for a while: large files and scans take longer. A job that gets stuck is marked Failed after about two hours, and then you can try again.

Once the new copy is ready, delete the failed one so it does not show up in the library twice.

Find and filter documents

  • Type part of a file name in the search box above the table ("Search by name"). It searches the folder or case you have open; if nothing matches there, "Look in all documents" searches the whole library. The top-bar search ("Search documents…") searches the whole library by name.
  • Use the status filter to show All, Ready, Processing or Failed documents. Each status shows a count.
  • The "Added in" filter (next to the status filter, set to "All modules") shows only documents that came in through one module, for example Translation or Smart Processing. Choose "All modules" to see everything again. A document that came in through another module carries that module's name as a tag.
  • The library shows 25 documents per page, with a "1–25 of N" footer and Previous and Next buttons. Page, search and status stay in the address, so you can share a link to a view.
  • To find a document by what it says rather than its name, ask Acta a question instead.

Columns are Name, Status, Owner (who uploaded it), Added and Actions. Clicking a document's name opens its own page: the viewer, Acta's summary, and details (type, size, when it was added, which module it came from).

The document page

A document opens on its own page with a back link to the library. The viewer shows:

  • PDFs, page by page, with zoom. You can jump to a page; the page is kept in the address.
  • Word files, drawn in the browser.
  • Plain text on a paper-style page.
  • JPG and PNG as pictures.

Other kinds (spreadsheets, presentations, TIFF, WEBP, HEIC, emails) have no preview in Acta; you download them instead. The header has a Download button. Page counts are shown for PDFs only.

A document that Acta made from two files (for example an original and a translation) has a version switch and a Side by side view.

Row actions (the ••• menu)

Each row has a ••• menu with:

  • Open: opens the document's page.
  • Try again: for failed documents.
  • Rename: changes the name, keeping the file extension.
  • Move to…: moves it to a folder.
  • Download.
  • Add to case… (or Change case…) if Clients & Cases is on.
  • Delete: moves it to Trash, after you confirm.

Rename, Move to… and Delete show only on documents you added. Owners and admins see them on every document.

To rename a document: open the ••• menu, click Rename, change the name and click Save. The file extension stays as it was.

To download a document: open the ••• menu and click Download, or use the Download button on the document's page. Originals sent to Anonymization are view-only and have no Download.

You can also select several documents with the check boxes. A bar then offers Ask a question (about the selected documents), Move, Add to case and Delete (to Trash), plus Clear selection. A checkbox in the header selects all documents on the page.

Folders

On wide screens the library has a folder tree on the left. On small screens it is a picker. It lists:

  • All documents.
  • Your folders, which can sit inside other folders.
  • Cases that have Knowledge Base documents (the same documents, filed by case).
  • Trash, always last.

The address shows what you are looking at: a folder or a case. The folders inside the open folder are listed above its documents.

To work with folders:

  1. Create: click New folder. If a folder is open, the new one is created inside it. Folder names are 1 to 120 characters and must be different from the other folders at the same level.
  2. Rename: use the pencil next to the breadcrumbs.
  3. Delete: open the ••• menu next to the breadcrumbs and choose Delete folder. The folders inside it are deleted too, but its documents stay in the library, under All documents.

Folders can be renamed but not moved to another place. A document is in one folder or none. To move documents, use Move to… on a row, or select several and click Move.

To move documents into a folder:

  1. Open the ••• menu on a row and click Move to…, or tick several rows and click Move in the bar.
  2. Choose the folder (or "No folder (All documents)") and click Move.

Ask about a whole folder: open it and click "Ask about this folder". Acta searches the documents in it and in the folders inside it. For a case, use "Ask about this case". Only Ready documents are used.

Trash

Deleting a document moves it to Trash. It is not gone yet:

  • Trash is a place in the library tree, last in the folder list.
  • Trashed documents are left out of the library, Ask Acta and the document pickers.
  • A trashed document keeps its folder. You can Restore it, and it goes back into that folder.
  • Documents stay in Trash for 30 days. The Trash page shows "Deleted … ago" and "N days left" for each one. After 30 days they are deleted for good (index, file and record) the next time someone opens Trash.
  • You can Delete forever one document, or use Empty Trash to remove everything in it. These can't be undone, and each asks you to confirm.

To bring a document back: open Trash in the folder tree, find it and click Restore. It returns to the folder it was in, and Ask Acta can use it again.

Members rename, move, delete, restore and delete forever only the documents they added; owners and admins can do this with every document, and only they can use Empty Trash. A translation, anonymized copy, draft or result counts as added by the person who started it. Anyone can still open, download, ask about and file any document under a case. If a rename or delete is refused, the document was added by a colleague: ask them, or an admin.

Add to case

If the Clients & Cases module is on, you can file documents under a case when you upload them, or later with "Add to case…" in the row menu. See the Clients and cases guide.

Add a result to the Knowledge Base

What Acta makes in other modules (translated documents, anonymized copies, processing results) does not join the Knowledge Base by itself. In that module's row menu, choose "Add to Knowledge Base" (for example "Add translation to Knowledge Base"). After it is added, the item shows "Open in Knowledge Base". Once added, it is indexed and Ask Acta can use it. Translations, copies and results show their own module's name in the "Added in" filter.

Common problems

  • A document is missing from Ask Acta's answers: check that it shows Ready, and that it is not in Trash.
  • Upload says files were skipped: they were not one of the accepted types, or were over 50 MB. Convert or shrink them and upload again.
  • "Upload at most 20 files at a time": upload in batches of 20.
  • A document has no preview: spreadsheets, presentations, TIFF, WEBP, HEIC and emails are only offered as a download.
  • You can't find a document by a phrase inside it: the search box finds names only. Ask Acta reads what is inside.

Limits

  • 50 MB per file, 20 files per upload.
  • 25 rows per page in lists.
  • A document in Trash is deleted for good after 30 days.
  • Failed files can be retried from the ••• menu.

See what Acta can do for your office

Tell me which tasks take your office the most time, and I’ll tailor a free demo to them.

Request a demo