> For the complete documentation index, see [llms.txt](https://docs.cogram.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cogram.com/projects/file-server.md).

# Your file server

Browse, search, preview, and upload files on your organization's own file server, without leaving Cogram or mapping a drive.

If your organization connects its file server to Cogram, those files appear under **Files**. You browse the same shares you see in Windows Explorer, and you see exactly the files your own account can open there.

The files stay on your organization's server. Cogram reads them when you ask for them.

## What you can do

* Browse shares and folders, with sizes and dates
* Search the whole file server by file name and by text inside documents
* Preview a file without downloading it
* Upload files into a folder, if your organization has turned that on
* Export a project's completed items into a folder, if your organization has set up [File export](https://docs.cogram.com/integrations/file-export.md)

## Finding a file

### Browsing

Go to [Files](https://app.cogram.com/dashboard/files) in the left navigation. You start at the list of shares, for example Engineering, Finance, and Shared. Click a folder to open it, and use the trail at the top or your browser's Back button to go back up.

Each folder shows its total size and how many files it holds, counting only the files you can read.

### Searching

Type in the search box on the Files page to search the whole file server. Cogram searches file names and the text inside documents, so "curtain wall" finds a specification that mentions it even when the file is named `07-5400.docx`.

Files also appear in the global search you open with **⌘K** (**Ctrl+K** on Windows), under **File server**. Select a result to open its preview.

## Previewing a file

Select any file to open it. PDFs and images render in full. Word documents, Excel workbooks, CSVs, and text files show their extracted text, which is enough to confirm you have the right file before you open it properly.

The panel on the right shows the file's name, type, size, created and modified dates, and its full location on the server. Use the location when you need to tell a colleague where a file lives.

## Uploading files

Uploading is available only if your organization has enabled it. If you do not see an **Upload** button, it is off, or you are at the top level. You can only upload into a folder, not into the list of shares.

In a folder that you can read but not write to, **Upload** and **New folder** are grayed out. Hover over them to see "You can't add files or folders here. Ask whoever manages your file server for write access."

1. Open the folder you want the file to go into.
2. Select **Upload**, or drag files onto the file list.
3. Watch the progress under the toolbar. The file appears in the list when it is saved.

Cogram writes the file to your file server only where your own account could have written it. If you cannot save a file to that folder from Windows Explorer, the upload is refused too.

### What good looks like

The upload row shows a check mark, then disappears, and the file is in the list with its size and today's date. You can find it in search straight away.

## Exporting a project to your file server

Cogram can file a project's completed items into one folder on your file server, and keep adding new ones as they are completed. Cogram only adds files. It never overwrites or deletes them.

Administrators set the rules for the whole firm, and project owners and leads link a project to its folder. See [File export](https://docs.cogram.com/integrations/file-export.md) for the steps and for what each type of item writes.

### What good looks like

The project's start page shows the folder under **File server**, with **Up to date** next to it. Open the folder in **Files** and the subfolders are there, with the exported files inside.

## Troubleshooting

#### Files is missing from navigation

Files does not appear in the navigation.

* **Likely cause:** Your organization has not connected a file server.
* **Fix:** Ask an administrator to connect it under [Organization Settings → Integrations → File Server Connectors](https://app.cogram.com/dashboard/settings/admin/integrations#connectors). Setup is covered in [Connecting your file server](https://docs.cogram.com/integrations/connecting-your-file-server.md).

#### Folder looks empty

A folder is empty, but you know it has files in it.

* **Likely cause:** Your account does not have read access to those files on the file server.
* **Fix:** Ask whoever administers the file server for access. Permissions come from the file server, not from Cogram, so changing your Cogram role does not help.

#### File server is unavailable

"The file server is unavailable."

* **Likely cause:** The connector on your organization's server is not running.
* **Fix:** Ask an administrator to check it. Your files are unaffected.

#### File already exists

"*name* already exists in this folder."

* **Likely cause:** A file of that name is already there.
* **Fix:** Cogram never replaces a file on your server. Rename your copy, or upload it to a different folder.

#### No permission to add files

"You do not have permission to add files to this folder."

* **Likely cause:** Your account has read access to that folder, but not write access.
* **Fix:** Ask whoever administers the file server to give you write access to that share.

#### Upload and New folder are grayed out

**Upload** and **New folder** are grayed out, with "You can't add files or folders here."

* **Likely cause:** Your account has read access to that folder, but not write access.
* **Fix:** Ask whoever administers the file server for write access to that folder.

#### Field reports failed with no template

Field reports are counted as failed, with "no template".

* **Likely cause:** The report's type has no default export template, so Cogram cannot build the Word file.
* **Fix:** Ask an administrator to set a default template for that report type.

#### Connector is read-only

The export settings say the connector is read-only.

* **Likely cause:** Writes are off for the connector.
* **Fix:** Ask an administrator to turn on writes with `configure.ps1 -AllowWrites` on the connector's server. See [Change settings after installing](https://docs.cogram.com/integrations/connecting-your-file-server.md#change-settings-after-installing).

## Things to know

* Uploaded files are owned by the Cogram connector's service account on the file server, not by you. Cogram records who uploaded each file.
* Cogram does not scan uploads for viruses. Upload only files you trust, exactly as you would when saving to a shared drive.
* Cogram never deletes, renames, or overwrites anything on your file server.
* Cogram exports each item once. If you unlink a folder and link it again, Cogram does not export those items a second time.
* A folder that a project exports into is marked in **Files**, so you can see which folders Cogram writes to.

## Next steps

* [Agent](https://docs.cogram.com/agent/agent.md) can search and read these same files when you ask it a question.
* [Privacy and confidentiality](https://docs.cogram.com/get-started/privacy-and-confidentiality.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cogram.com/projects/file-server.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
