> ## Documentation Index
> Fetch the complete documentation index at: https://docs.navisops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Store and manage files in the cloud

> Upload any file type, organize in nested folders, preview images and PDFs in-app, and link files directly to projects — all within your Navis Ops workspace.

Files gives you private cloud storage inside Navis Ops so you don't need a separate drive just to keep project assets alongside your tasks and notes. You can upload anything, preview common formats without downloading, organize with nested folders, and link files to projects so the right materials are always in context.

## Getting started

<Steps>
  <Step title="Open Files">
    Click **Files** in the sidebar. If it isn't pinned, find it under **More**.
  </Step>

  <Step title="Upload a file">
    Drag a file from your desktop onto the Files page — anywhere on the page works. Or click **Upload** to open a file picker. Your file appears in the list once the upload completes.
  </Step>

  <Step title="Preview it">
    Click the file to open an in-app preview. Images, PDFs, audio, video, and text files all render inline.
  </Step>

  <Step title="Organize">
    Use the folder rail on the left to create folders and move files between them.
  </Step>
</Steps>

<Info>
  Files is an opt-in feature. If you don't see the Files page in your sidebar or under More, contact support to have it enabled for your account.
</Info>

## What you can do

<CardGroup cols={2}>
  <Card title="Upload anything" icon="cloud-arrow-up" href="/guides/files#uploading-files">
    Drag-and-drop or pick from a dialog. Up to 500 MB per file.
  </Card>

  <Card title="In-app previews" icon="eye" href="/guides/files#previewing-files">
    View images, PDFs, audio, video, and text files without downloading.
  </Card>

  <Card title="Folder organization" icon="folder-open" href="/guides/files#folder-organization">
    Nest folders as deep as you need and drag files between them.
  </Card>

  <Card title="Trash and restore" icon="trash" href="/guides/files#trash-and-restore">
    Soft-delete with a 30-day window to restore before auto-purge.
  </Card>

  <Card title="Project linking" icon="link" href="/guides/files#project-linking">
    Link files to projects so they appear in the project's Files tab.
  </Card>

  <Card title="Storage usage" icon="chart-bar" href="/guides/files#storage-usage">
    See total bytes used at a glance from the Files page header.
  </Card>
</CardGroup>

## Uploading files

You have two ways to upload:

* **Drag-and-drop** — drag one or more files from your computer onto the Files page (or directly onto a project's Files tab). The page accepts drops anywhere in the main area.
* **Upload button** — click **Upload** in the top-right corner to open a file picker. Select one or more files to start the upload.

Files of any type are accepted. The only hard limit is **500 MB per file**. If a file exceeds 500 MB, the upload fails with a clear error before any data is transferred.

<Tip>
  To upload a file and link it to a project in one step, drag it onto the project's **Files** tab instead of the main Files page. It uploads to your workspace and links to the project automatically.
</Tip>

## Previewing files

Click any file to open its preview. What you see depends on the file type:

| File type                          | Preview                              |
| ---------------------------------- | ------------------------------------ |
| Images (JPG, PNG, GIF, WebP, etc.) | Full inline render                   |
| PDF                                | Paginated inline viewer              |
| Audio (MP3, M4A, WAV, etc.)        | Built-in audio player                |
| Video (MP4, MOV, etc.)             | Built-in video player                |
| Text and Markdown                  | Rendered text (first 200 KB)         |
| SVG                                | Download only (blocked for security) |
| Everything else                    | Download only                        |

<Note>
  Text and Markdown previews are capped at 200 KB. If your file is larger, the preview shows the first 200 KB. The full file is always downloadable.
</Note>

## Folder organization

Create nested folders to keep related files together.

<Steps>
  <Step title="Create a folder">
    Click **New folder** in the folder rail or the toolbar. Type a name and press Enter.
  </Step>

  <Step title="Nest folders">
    Right-click an existing folder and choose **New subfolder**, or drag one folder onto another in the rail.
  </Step>

  <Step title="Move files">
    Drag a file card onto any folder in the left rail to move it there.
  </Step>

  <Step title="Rename or delete">
    Right-click any folder to rename or delete it. You can also click the folder's menu (⋯) to access these options.
  </Step>
</Steps>

<Warning>
  Deleting a folder soft-deletes **everything inside it** — the folder and all its files move to Trash together. Restoring the parent folder does **not** automatically restore its contents. You'll need to restore each file individually from Trash.
</Warning>

## Trash and restore

When you delete a file or folder, it moves to **Trash** rather than being removed immediately.

* Files in Trash are **not counted** toward your storage total.
* You have **30 days** to restore a trashed file before it's permanently deleted. There's no notification before auto-purge happens.
* To restore: open Trash (link in the sidebar or folder rail), find the file, and click **Restore**.
* To delete immediately: open Trash and click **Permanent delete** on the file.

<Warning>
  After 30 days, trashed files are purged permanently and cannot be recovered. Plan restores before the window closes.
</Warning>

## Project linking

Linking a file to a project makes it appear in the project's **Files** tab and in the **Files** widget on the project dashboard.

**Two ways to link:**

1. From the project's **Files** tab — drag a file onto the tab to upload and link in one step, or use the **Link file** button to link a file that's already in your workspace.
2. From a file's detail view — open the file, click **Link to project**, and pick the project.

Linked files continue to live in your main Files area as well. The link is a relationship, not a copy — the same file appears in both places.

## Storage usage

The storage strip at the top of the Files page shows your total bytes used in real time. Trashed files don't count toward the total. The workspace cap is **500 MB** across all files.

You can also see storage usage from the **Files** widget on any project dashboard.

## Walkthrough: file your project's reference assets

You're starting a client project and want the brand guide and kickoff recording in one place.

<Steps>
  <Step title="Open the project's Files tab">
    Go to the project's detail page and click the **Files** tab.
  </Step>

  <Step title="Upload the brand guide">
    Drag the brand guide PDF onto the tab. It uploads to your workspace and links to the project automatically. Click the file to preview it inline — no download needed.
  </Step>

  <Step title="Upload the kickoff recording">
    Drag the recording (`.mp4` or `.m4a`) onto the tab the same way. Click it to play inline via the built-in video or audio player.
  </Step>

  <Step title="Find them later from either view">
    Switch to the **Files** page in the sidebar. Both files appear there with project chips showing which project they're linked to. You can navigate to them from the project tab or from your full file library.
  </Step>
</Steps>

## Limitations

| What you'll hit                        | Detail                                                                                                                                                     |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **500 MB per file**                    | Hard cap enforced before upload starts. Split or compress files that exceed this limit.                                                                    |
| **500 MB workspace total**             | The combined size of all your files (not counting Trash) cannot exceed 500 MB.                                                                             |
| **No public file sharing**             | All files are private to your account. There's no share link or password-protected URL. To share, download and send the file.                              |
| **Files are immutable once uploaded**  | There's no in-place editing. To update a file, delete the old one and re-upload. Renaming only changes the display name — the storage path doesn't change. |
| **SVG preview is blocked**             | SVG files are download-only because SVG can carry executable script.                                                                                       |
| **Text preview capped at 200 KB**      | Larger text or Markdown files are truncated in preview. The full file downloads correctly.                                                                 |
| **Folder delete cascades to contents** | Deleting a folder soft-deletes everything inside. Restoring the folder doesn't restore its contents automatically.                                         |
| **No in-app file editing**             | Files is an object store, not a document editor. Use [Notes](/guides/notes) for editable rich text.                                                        |
| **No per-file access control**         | Files are visible only to you. There's no "share with this teammate" option.                                                                               |
| **Trash auto-purges after 30 days**    | No warning is sent before purge. Monitor your Trash if you need to restore files.                                                                          |

## FAQ

<AccordionGroup>
  <Accordion title="Can I share a file with someone outside my workspace?">
    Not directly from Files. Download the file and send it through another channel. For shareable live HTML/CSS/JS demos, use [Code Pens](/guides/code-pens) instead.
  </Accordion>

  <Accordion title="I uploaded a file by accident. How do I remove it?">
    Click the file, then **Delete**. It moves to Trash for 30 days. From Trash, click **Permanent delete** to remove it immediately, or just leave it — it auto-purges after 30 days.
  </Accordion>

  <Accordion title="I deleted a folder by accident — how do I recover it?">
    Open Trash and restore the folder. Then open Trash again and restore each file that was inside the folder individually. Restoring the folder doesn't restore its contents automatically.
  </Accordion>

  <Accordion title="How much storage am I using?">
    Check the storage strip at the top of the Files page. It shows your live total. Trashed files are excluded from the count.
  </Accordion>

  <Accordion title="My upload failed with 'file too large' — what now?">
    The 500 MB cap is enforced in your browser before any data is sent. Compress the file, split it into parts, or use an external storage service for very large assets.
  </Accordion>

  <Accordion title="Can a Code Pen reference an image stored in Files?">
    No — Files are private. Your Code Pen's preview iframe can't access private storage. Use a public CDN (GitHub raw, Unsplash, Imgur) for any images or assets a pen needs to load.
  </Accordion>

  <Accordion title="Why can't I preview my SVG file?">
    SVG files can carry executable JavaScript, so Navis Ops blocks inline preview as a security precaution. Click **Download** to view the file locally.
  </Accordion>

  <Accordion title="Do linked files count toward a project's storage?">
    No. All files count toward your single workspace storage total, regardless of how many projects they're linked to. Links are relationships, not copies.
  </Accordion>
</AccordionGroup>

## See also

<CardGroup cols={2}>
  <Card title="Notes" icon="file-lines" href="/guides/notes">
    Write editable rich-text content instead of uploading a Word doc or PDF.
  </Card>

  <Card title="Projects" icon="folder-open" href="/guides/projects">
    Link files to projects and access them from the project's Files tab.
  </Card>

  <Card title="Code Pens" icon="pen-to-square" href="/guides/code-pens">
    Share HTML/CSS/JS demos publicly without needing private file hosting.
  </Card>

  <Card title="Dashboard" icon="chart-bar" href="/guides/dashboard">
    Add a Files widget to your project dashboard for quick access.
  </Card>
</CardGroup>