Upload and export docs

Upload adds the docs that your team already has. Export downloads your docs as plain Markdown. This page tells you how to do both and how to read the result.

What you can upload

You can upload these files:

Markdown files (.md) and plain text files (.txt).
A folder of such files. kmem keeps the subfolders.
One zip file of such files. An Obsidian vault in a zip works too.

The Upload docs page shows the limits before you choose files: Up to 300 files · 976.5 KB per file · 25 MB per zip.

These rules also apply:

kmem reads one zip in each upload. Upload a second zip on its own.
Upload a zip without other files. Upload the other files after the zip.
kmem does not add README.md, AGENTS.md, CLAUDE.md or the .signpost folder as docs. Rename such a file to add it.
kmem does not add images or other file types. It tells you which files it left out, and why.

Upload docs

Select Connect, then Upload. You can also select Upload docs in Docs.
Add the files in one of these ways:
Drop the files, a folder or a zip on the page.
Select Choose files.
Select Choose a folder.
Check the list of files. kmem marks each file that it cannot upload, with the reason. Select Clear selection to start again.
Choose a destination folder. The next section explains this step.
Select the upload button, for example Upload 18 files.

kmem shows the progress. Keep the page open until the browser sends every file. After that, you can leave the page. The upload continues, and you can come back to it from Recent uploads.

Select Cancel upload to stop the upload before every file arrives. kmem then adds nothing.

Nothing changes an existing doc without a person. A file that would change an existing doc goes to Review.

Choose a destination folder

Use Add to folder to choose where the new docs go:

All docs puts the files at the top level. kmem keeps the folders in your selection, for example handbook/onboarding.md becomes the doc handbook/onboarding.
An existing folder puts the files in that folder, and keeps the folders in your selection below it.
A new folder puts the files in a folder that you name. Type the name in New folder name, for example handbook.

kmem shows where the new docs will go before you upload.

To upload into a folder from Docs, open the folder options menu, and select Upload to this folder.

Read the upload result

When the upload ends, kmem shows Upload complete and the totals, for example 12 docs added · 5 skipped · 1 sent to review.

The table shows each file with its outcome. Use Outcome to show one outcome only.

Outcome	What it means
Added	kmem added the file as a new doc. It is ready to read.
Skipped	kmem did not change your org. For example, the file matches an existing doc.
Sent to review	The file would change an existing doc. The change waits in Review for a person.
Failed	kmem could not add the file.

Each row also gives the reason. These are the common reasons, with what to do:

Reason	What to do
This file matches an existing doc.	Nothing. The doc is already in kmem.
This file would change an existing doc.	Decide the change in Review.
This change is already waiting in Review.	Decide the earlier change in Review.
kmem keeps README.md, AGENTS.md, CLAUDE.md and the .signpost folder out of the knowledge base. Rename the file to add it as a doc.	Rename the file, then upload it again.
This file name cannot become a doc address. Rename the file and upload it again.	Rename the file, then upload it again.
Two files in this upload share one address. Rename one and upload it again.	Rename one of the files, then upload it again.
This file is too large for one doc. Split it into smaller files and upload them again.	Split the file, then upload the parts.
kmem could not process this file. Retry it, or upload it on its own.	Select Retry failed files, or upload the file alone.

Each row has actions:

Open doc opens a doc that the upload added.
Open existing doc opens the doc that a skipped file matches.
View change opens the change in Review.
Use this file instead is for a file that disagrees with an existing doc. The next section explains it.

Below the table, use these actions:

Review 1 change opens Review. The count shows the number of changes.
Open docs opens Docs.
Download result downloads the table.
Retry failed files uploads the failed files again.
Upload more starts a new upload.

If kmem says You cannot add a doc at this address. Choose another folder, or ask an owner for access., you cannot write in that folder. Choose another destination.

Use this file instead

A file can say something different from a doc that already exists. kmem then sends the file to Review. You can decide in Review, or you can use the file at once:

In the result table, select Use this file instead on the row of the file.
Read the message Use this file instead?.
Select Use this file. Select Cancel to stop.

kmem adds the file to Docs. It marks each doc that the file still disagrees with as superseded. Search, Ask and agents then leave out a superseded doc.

Recent uploads

Recent uploads on the Upload docs page lists your last uploads. Each row shows the status, the time and the result.

Status	What it means
Waiting	The files arrived. kmem starts to add them soon.
In progress	kmem adds the files now.
Complete	The upload ended with no failure.
Needs attention	The upload ended, and some files need a decision or failed.
Failed	The upload stopped.

Select View result or View progress to open an upload.

If an upload takes long, kmem restarts it. Keep the page open, or come back later.

Export docs

Every member can export the docs that they can read. You do not need to be an owner or an admin.

Open the account menu, and select Export docs. An owner or an admin can also open Org settings, then Export.
Under Folders, select the folders to export. Select Every folder to export all of them.
In Single docs, you can add the addresses of single docs, one address on each line, for example handbook/onboarding.
Under Format, choose one format:
One Markdown file, everything inlined. All docs in one file.
A zip with one file per doc and its folder path. The same structure as in kmem.
Read the summary. It says what the export holds.
Select Export docs.

kmem downloads the file. A message gives the name of the file and the number of docs in it.

If kmem says that the export stopped at a limit, the file does not hold everything that you chose. Export fewer folders at a time.

If kmem says that no doc you can read is at an address, check the address against the address of the doc.

What an export holds

Each doc as the Markdown that kmem stores. kmem does not change the text on the way out.
The folder path of each doc, in a zip.
The access lists and the visibility of each doc, because they are part of the Markdown.

An export holds only the docs that you can read. It does not hold images that kmem stores. A doc keeps the address of each image.

You can open the files in any text editor. You can upload a zip export into another org.