# File Storage

> Part of the NocoDB documentation (Product docs > Sync > App Sync). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/product/sync/app-sync/file-storage
Last updated: 2026-09-25

Bring file and folder metadata from cloud storage platforms into NocoDB with automated syncs.

File Storage Sync enables you to import file and folder information from your cloud storage platform. It follows a predefined schema that standardizes storage data across systems, so you can audit what lives where, track sizes and types, and build file inventories across your drives.

Current supported sources include:

* Google Drive
* Dropbox
* Box

## Available Tables

Each table is mapped to a well-defined set of fields to maintain a unified structure. App Sync also includes relational fields that connect files to their folders.

### **FS\_File**

Represents file metadata from the connected storage platform.
**Key fields include:**

* **Name** – The file name.
* **File URL** – Direct link to the file in the source platform.
* **File Thumbnail URL** – Link to the file's thumbnail, where available.
* **Size** – File size.
* **Mime Type** – The file's content type.
* **Description** – File description, where the source provides one.
* **Checksum** – Content checksum for change detection and verification.

Each File links to its parent **Folder**.

### **FS\_Folder**

Represents folder metadata, organizing files into their hierarchy.
**Key fields include:**

* **Name** – The folder name.
* **Folder URL** – Direct link to the folder in the source platform.
* **Size** – Folder size, where the source provides it.
* **Description** – Folder description, where available.

Folders are linked to the **Files** they contain and to their parent **Folders**, mirroring the source hierarchy.

## Metadata Fields

Each synced table in the File Storage category includes a set of metadata fields that track the lifecycle, state, and origin of every record. These fields provide transparency into how data flows from the external source into NocoDB and play an essential role in traceability, debugging, and audit requirements.

These metadata fields are automatically managed by App Sync and are read-only.

* **RemoteId**
  Unique identifier of the record in the external source system.

* **RemoteCreatedAt**
  Timestamp of when the record was originally created in the source.

* **RemoteUpdatedAt**
  Timestamp of the most recent update made in the source.

* **RemoteDeleted**
  Indicates whether the record has been deleted in the source platform.
  This is used especially when the delete behaviour is set to **Ignore**.

* **RemoteDeletedTime**
  Timestamp of when the record was deleted in the source, if applicable.

* **RemoteRaw**
  Stores the raw payload received from the provider for that record.
  Useful for troubleshooting, verification, or advanced integrations.

* **RemoteNamespace**
  Identifies the origin drive or account, depending on the provider.

* **RemoteSyncedAt**
  Last timestamp when NocoDB synced this specific record.

* **SyncConfigId**
  Internal reference to the sync configuration used for this record.

* **SyncRunId**
  Identifies the specific sync execution run that last updated this record.

* **SyncProvider**
  Indicates which external service (Google Drive, Dropbox, or Box) the record originated from.

## Good to know

* File Storage Sync imports **metadata** about files and folders — names, locations, sizes, and related details — not the file contents themselves.

## Availability

* App Sync is available on **NocoDB Cloud** (Plus plan and above) and licensed self-hosted deployments (Business plan and above).

---

## Related pages

- [Ticketing](https://nocodb.com/docs/product/sync/app-sync/ticketing.md): Bring ticketing data from popular platforms into NocoDB with automated syncs.
- [HRIS](https://nocodb.com/docs/product/sync/app-sync/hris.md): Bring employee data from your HR system into NocoDB with automated syncs.
- [CRM](https://nocodb.com/docs/product/sync/app-sync/crm.md): Bring customer and contact data from your CRM into NocoDB with automated syncs.
- [Calendar](https://nocodb.com/docs/product/sync/app-sync/calendar.md): Bring your calendar events into NocoDB with automated syncs from Google Calendar, Outlook Calendar, and CalDAV.
- [Custom Sync](https://nocodb.com/docs/product/sync/app-sync/custom.md): Mirror tables from PostgreSQL, MySQL, or SQL Server databases into NocoDB as read-only synced tables.