User Guide
User Manual
How to actually use SmartKMS day to day — logging in, uploading and finding documents, chatting with the AI assistant, and what each role can do.
Logging In
A fresh install seeds one admin account per college, plus one account for each other role, all in the College of Information Technology (CIT):
| College | Password | |
|---|---|---|
| College of Information Technology | admin@cit.edu | Admin@CIT2026 |
| College of Arts and Sciences | admin@cas.edu | Admin@CAS2026 |
| College of Engineering | admin@coe.edu | Admin@COE2026 |
| College of Business Administration | admin@cba.edu | Admin@CBA2026 |
| Administration | admin@adm.edu | Admin@ADM2026 |
| Password | Role | |
|---|---|---|
| faculty@cit.edu | Faculty@2026 | faculty |
| staff@cit.edu | Staff@2026 | staff |
| researcher@cit.edu | Researcher@2026 | researcher |
Start with admin@cit.edu / Admin@CIT2026 for most testing.
Checking "Remember me" on login keeps the session active across browser restarts; leaving it unchecked ends the session when the browser closes. After five failed login attempts, an account locks for 15 minutes.
Signing out and the account menu
Your name and role sit at the bottom-left of the sidebar (just your initials when the sidebar is collapsed). Click that block to open the account menu: Help expands to About SmartKMS (this documentation), Getting started (a checklist of first things to try, which ticks itself as you add a photo, ask the Q&A assistant and upload) and Terms of Service, and Log out signs you out after a confirmation.
Roles and Permissions
Four roles, increasing in permission:
| Role | Can do |
|---|---|
| Researcher | View documents shared with them, use AI Search and Chat |
| Faculty | Everything Researcher can, plus upload documents |
| Staff | Everything Faculty can, plus manage documents and review reapproval requests |
| Admin | Full access — manage users, organizations, all documents, and reapproval requests, across every college |
Document Visibility
| Setting | Who can find it |
|---|---|
| Private | Only the person who uploaded it |
| Public | All users in the same college |
| Global | All users across every college |
| Cross-Org | Everyone in your college, plus the other colleges you pick — see Sharing a document |
| Shared | Only the people you name by email, each with can view or can edit, with or without download — see Sharing a document |
Change a document's visibility from the access chip at the top-right of the document viewer (the button showing Private / Public / Shared / …). Only the uploader or an admin can change it.
Dashboard
The landing page after login — a stats overview, your five most recent documents (click one for a quick preview) and your five most recent AI conversations (click one to resume it in the chat page).
Documents
Where documents are uploaded, organized, and managed.
Uploading a document
- Drag a file onto the upload zone, or click Browse Files (PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, PNG, JPG)
- Fill in the document title
- Click Upload Document — it goes live immediately, no manual approval step needed
- Wait 30–60 seconds while a background job extracts text, generates a search embedding, an AI summary and a few topic tags, and screens the content — the card shows live status the whole time, and the document is badged Analyzing… until the screen clears it (it then shows as Approved; only documents the screen couldn't decide on are left as Pending review for an admin)
From Google Drive or OneDrive: when the server administrator has turned it on, Google Drive and OneDrive buttons sit under Browse Files. Connect your account in the window that opens (read-only, for about an hour), pick up to 20 files, and click Import; they're processed like any upload. Google Docs, Sheets and Slides arrive as Word, Excel and PowerPoint files.
Up to 500 MB per file. If SmartKMS's storage is nearly full, an upload that wouldn't fit is refused before anything is stored, with a message to ask an administrator to free up space. Administrators see a banner on every page from 80% full, with the space used, so they can act before that happens.
Changed your mind mid-upload? Click the × on the processing card to cancel — this stops the pipeline and removes the file from storage immediately, rather than leaving it half-processed.
Archiving outdated documents
The uploader, or an administrator, can Archive a document from its right-click menu or the viewer's File menu when it is out of date or was uploaded by mistake. It leaves Documents, AI Search and the Q&A Assistant for everyone else, and old links say it is no longer available. The Archive page in the sidebar lists what you archived (administrators can switch to everyone's), and Retrieve puts a document back exactly as it was.
Sensitive-content screening
Every upload is automatically screened before it's visible to anyone else. Text is checked for leaked personal information (IDs, medical/financial records, private addresses); images are checked by a vision model for explicit content. Sex-education material, historical imagery, biographical content about public figures, and blank forms or templates (a field like "TIN: ____" with nothing filled in) are deliberately not flagged. If a document is auto-rejected, you'll see a notification once processing finishes, along with the reason. If a check can't run (for example, the AI model is down), the document waits for a person instead of being approved. In the viewer, How this was decided under Approval lists each check, its model and what it found, and any person's decision, which always overrides the checks.
Requesting reapproval
If your document is rejected and you believe it shouldn't have been, open it and click Request Reapproval. You'll be asked for:
- A title for the request
- One or more common reasons (the AI flagged it incorrectly, you've since updated the content, or the context was misunderstood — e.g. it's educational, not what it was flagged for)
- An optional free-text description — required if none of the checkboxes apply
An admin or staff member reviews it from the Reapprovals queue (see below). You'll be able to see the outcome and any note left by the reviewer.
Organizing documents
- Folders — create, share, rename and delete folders; drag a document onto a folder (or the breadcrumb) to move it. A folder has the same sharing levels as a document, and works like Google Drive: everyone who can open a folder can open every document in it, even Private ones. A document shared more widely than its folder keeps its own audience, and people who can't open the folder see it on its own. New folders start Private. Faculty, staff and admins can share, rename and delete any folder they can see in their college; researchers are read-only. Moving a document into a folder that would open it to more people asks first.
- Right-click menus and selecting several — right-click any document or folder, in the list or the grid, for what you can do with it (Open, Download, Rename, Remove from folder, Move to Trash; for folders Open, Share, Rename, Delete). Select several like in Windows Explorer (Ctrl+click to add, Shift+click for a range, Ctrl+A for all, Esc to clear; or right-click > Select) and move them to the Trash together. A plain click still opens a document.
- Trash — deleting a document moves it to the Trash (in the menu) for 30 days. Restore puts it back exactly as it was; Delete forever or Delete all removes it now, and Restore all puts everything back. Click a row to select it (Ctrl+click or Shift+click to add more) to restore or delete several together, or right-click a row. The time left reads N days left, in red in the last 3 days. After 30 days its file is removed from storage for good. Your Trash lists what you uploaded; admins can switch to everyone's.
- Suggested folder — open a document you uploaded (or any document, as an admin) and the viewer shows which folder the AI thinks it belongs in, based on how similar it is to the documents already in each folder and on folder names. Click Move here to file it, or pick one of the alternatives. Nothing moves on its own; the card simply doesn't appear when there's no good match. If the suggestion isn't useful, close it with the ✕: the folders it showed are marked as not recommended and won't be suggested for that document again.
- Tags — every upload is tagged automatically by the AI with 2–5 topics, reusing tags your organization already has wherever they fit. Add or remove tags from the document viewer; tags you type during upload are kept alongside the suggested ones.
- List / Grid view — toggle from the view switcher; sort by name, owner, date modified, or file size
- Sharing — give specific people or other colleges access, with view-only or edit rights per person — see Sharing a document
Viewing and editing documents
Opening a document shows a preview — PDFs in the browser's own viewer (on phones and tablets, which have no built-in PDF viewer, SmartKMS draws the pages itself as you scroll), images in a zoomable viewer, Word/Excel/PowerPoint files in ONLYOFFICE's read-only viewer (if it's running). Click Edit to switch to the full editor (see Document Editing), then Save to keep your changes or Close — closing with unsaved edits asks whether to save, discard or keep editing. Every save creates a new version. For Office and PDF files, open the editor and use File → Version History to browse past versions (with changes highlighted for versions saved since 1.8.0) and restore an earlier one; restoring keeps the current content as a version you can go back to as well, so nothing is ever lost. After any edit or restore, the document's AI Summary refreshes itself in the background and updates in place once it's ready.
Previewing images
Images open in a zoomable viewer. Fit shows the whole picture inside the pane; + / − (or the mouse wheel) zoom in and out, dragging pans, and double-clicking toggles between Fit and actual pixel size. The maximize button at the top of the preview gives the image the full window. Tall images and long screenshots are no longer cropped — at Fit you see all of it, and when zoomed in you can scroll to any edge.
Sharing a document
Sharing is done from the Access section of the document viewer, and only the uploader or an admin can change it. Two kinds of sharing exist, chosen by the document's visibility:
With specific people (Shared)
- Open the document and set its access chip (top-right) to Shared.
- In the Access section click Add person by email and start typing a name or e-mail: matching SmartKMS accounts are suggested (people you've shared with recently first) — pick one with the mouse or ↑/↓ and Enter. The address must belong to an existing account — if it doesn't, you'll be told, and an admin needs to add the person first.
- Choose Can view or Can edit, and tick or clear Allow download, then click Share. Cancelling or closing the dialog shares nothing.
- To change it later, use the dropdown next to their name (Can edit, Can view, or No access to remove them) and the download checkbox beside it. Changes save immediately.
What each level means for the person you shared with:
| Can view | Can edit | |
|---|---|---|
| See the document in their list and open it | Yes | Yes |
| Preview, read the AI summary, search and chat over it | Yes | Yes |
| Download | Only with Allow download ticked, and only if the document itself isn't set to view-only. Without it, the Download buttons show a lock and the editor's own download and print are off | Same |
| Edit in the editor, save new versions, restore versions | No — the Edit button is replaced by a "View only" note, and the editor refuses to save | Yes |
| Change sharing, visibility or delete | No | No — only the uploader or an admin |
| See who else it's shared with | No | No — they see "Shared with you by … — view only / you can edit" |
No access removes the person: the document disappears from their list and opening it is refused. People from other colleges can be added too — the document appears in their list even though it belongs to your college. Sharing only takes effect while the document stays Shared: switch it to Private and the shares are dormant (they come back if you switch to Shared again).
With other colleges (Cross-Org)
Set the access chip to Cross-Org and tick the colleges in the Access section. Each ticked college gets the same choices as a person: Can view, Can edit or No access, plus a download checkbox. Everyone in your own college can view it too; the uploader, admins and staff of the owning college can always edit.
Only the uploader and admins see the access chip and the Rename / Delete options; everyone else sees how the document is shared with them in the Access section.
Approving / rejecting (admin)
Admins can approve, reject, or re-approve a document directly from the document viewer. Rejecting prompts for an optional reason, shown to the uploader.
Needs review. When the content screen has flagged documents, admins see a Needs review button on the Documents page with the number waiting. It lists every flagged document from every folder, with Approve and Reject on each row or tile, so most decisions don't need the document opened. Approving or rejecting in the viewer opens the next flagged document; after the last one the viewer stays on it with its new status. Show all documents returns to the normal list.
AI Search
Type a question in plain language — SmartKMS converts it into a vector and finds documents whose meaning is closest, not just documents containing the same words. Each result shows a relevance score and how it was found (Found by meaning, by document title, by tag and so on).
A misspelled search is corrected from the words in the documents you can open: when nothing matches what you typed you see Showing results for the corrected words (with Search instead for to keep your spelling), and when only weak matches were found, Did you mean …?.
Search boxes (including the Advanced search word fields and the Documents page filter) accept up to 500 characters — enough for any question or keyword list. To ask about a long passage of text, paste it into Q&A Chat instead.
Q&A Chat
Ask a question and get a direct answer synthesized from the most relevant documents, with citations linking back to the sources — this is Retrieval-Augmented Generation (RAG). Greetings and small talk ("hi", "who are you", "thanks") get a normal conversational reply with no document search or citations attached, so the assistant doesn't awkwardly cite a document that has nothing to do with what you just said.
New conversations are titled automatically from your first question — a short descriptive name rather than the question itself. In the history rail, hover a conversation and click ⋮ to Rename or Delete it (double-clicking the title also renames). Use Clear Conversation to permanently delete a chat session's history.
Answers stay polite: the assistant doesn't curse in any language, Filipino/Tagalog included, or repeat the user's curses, and any that slip through are shown as asterisks (G***). It gives a web link only when that exact address appears in one of the documents, such as a paper's DOI; any other link in an answer is shown as plain text.
A message can be up to 4,000 characters (roughly 600–700 words). Once you pass 3,200, a counter appears under the input; it turns red at the limit and the box stops accepting more. For longer material, upload it as a document and ask about it instead.
The first time you open it, the assistant says it is an AI and what that means, and its header says AI-generated answers from your documents. While it works, the SmartKMS mark turns next to a short list of what it is doing: reading the question, searching the documents (and how many it found), each document it reads, writing and checking sources. When the answer starts, the list folds into one line (Searched documents · read 3 documents · cited 2) that you can open again. You can stop a reply mid-way with the stop button; whatever had been written stays, marked as cancelled.
Answers mark their sources with small numbers after the statements they support; click a number to open that document. N sources under the answer opens the numbered list with an excerpt of each, and under the latest answer from documents, Follow-ups suggests two or three questions to ask next.
Why this answer?
The question-mark button under an answer shows how it was made: whether it came from your documents or from the model's general knowledge, which model wrote it, every document it was given with how it was found and how well it matched, which ones it cited and how that was decided, and whether your ratings shaped it. It is saved with the answer. Help → How SmartKMS uses AI describes every AI feature, following the EU AI Act's transparency principles.
You don't have to wait on the page: your question is saved as soon as you send it, and the answer keeps being written if you go to another page or close the tab. Come back mid-answer and you see what's written so far, then the rest live (Stop still works); come back later and it's there with its sources. If an answer couldn't be finished (for example, the server restarted), the conversation says This answer was interrupted before it finished, with Ask again.
Rating answers — and what it changes
Copy, thumbs up and thumbs down sit under the latest answer and appear under any other answer you point at; on phones and tablets they are always shown. Click a thumb to rate the answer (click it again to clear, or the other thumb to change your mind). Ratings are not just collected — they change later answers in two ways:
- Which documents get used. Every rated answer's sources vote for the documents behind it. Across your college, a document that keeps producing disliked answers is ranked lower when the assistant looks for sources, and one that keeps producing liked answers is ranked higher.
- How your similar questions are answered. When you ask something very close to a question you already rated, the assistant is shown your earlier answer with your verdict — a liked one as an approach to build on, a disliked one as something not to repeat. This memory is personal: your ratings never surface another person's answers to you, and yours are never shown to anyone else.
When either of these applied, the answer says so underneath: "Informed by your 1 disliked answer to similar questions" or "Informed by 3 document ratings from your organization". Ratings are kept per answer and survive a reload, so you can revisit and change them.
Reapprovals admin · staff
A table of reapproval requests from uploaders of rejected documents, filterable by Pending / Approved / Rejected / All and searchable across the document, request title, description, requester and rejection reason. Columns (Document, Request, Requested by, Date, Status) sort on click. Click a row to open the full request — the original rejection reason, the uploader's reasons and description, and any reviewer note — and, for pending requests, Approve (restores the document to Approved) or Reject (leaves it rejected, optionally with a note) from the same dialog. This page is only visible to admins and staff.
Analytics admin
Usage trends, knowledge gaps (searches that returned nothing useful), most-viewed documents, and top contributors.
Settings
- Profile — add a profile picture (click the circle with your initials; PNG, JPG, WebP or GIF up to 5 MB, cropped to a square), edit your name, email, and organization; change your password. Your picture appears on the sidebar account button and next to your name in the Documents and Reapprovals lists.
- Theme — pick a color theme (Ocean Blue, Teal, Purple, Crimson, Amber, Monochrome) and light/dark mode; your choice persists across every page. Amber uses the SmartKMS brand yellow and blue.
- User Management admin — edit any user's name, email, organization, and role, or deactivate an account
- Organizations admin — create, edit, and delete colleges, including a live color picker
- Backup & Restore admin — automatic backups every day, week or month at a set time, into a folder you choose, keeping the newest few; Back up now; download, upload, delete or Restore a backup (type RESTORE; a backup of the current data is made first and everyone signs in again). A backup is one .zip with the database, every document file, profile pictures and logos.