> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Wix Media Collections

## Article: Wix Media Collections

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/wix-app-collections/wix-media-collections.md

## Article Content:

# Wix Media Collections

This article explains the fixed permissions and field structure for the following Wix Media collections:

- [Files](#files)
- [FileshareFiles](#filesharefiles)
- [FileshareFolders](#filesharefolders)
- [Folders](#folders)

> **Note:** These collections are system collections, so you can't change their permissions in the CMS.

<blockquote class="tip">

**Tip:**
Before continuing, make sure you've read [Working with Wix App Collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code.md).

</blockquote>

## Files

This section explains the permissions and fields available in the Files collection.

> **Note:** When you add a file from your Media Manager to your site, the `Files` collection is automatically added to your site.

To use the Files collection in code, refer to it as `Media/Files`.

::::tabs
:::REST_TAB
```
curl -X POST \
  'https://www.wixapis.com/wix-data/v2/items/query' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "dataCollectionId": "Media/Files",
    "query": {}
  }'
```
:::
:::SDK_TAB
```js
import { items } from "@wix/data";

items.query("Media/Files")
  .find()
  .then((results) => {
    // handle the results
  });
```
:::
::::

> **Note:** When using this collection, you can't set up the site to [link to the next or previous dynamic page](https://support.wix.com/en/article/cms-linking-to-dynamic-pages#linking-to-the-next-or-previous-dynamic-page).

### Permissions

The Files collection has the following [permissions](https://support.wix.com/en/article/cms-collection-permissions-overview):

- `read`: `ANYONE`
- `create`: None
- `update`: None
- `remove`: None

### Fields

This section describes each field in this collection and its properties.

> **Note:** This app collection contains read-only fields that cannot be managed from the collection. You can update the fields from the relevant app in your site’s [dashboard](https://support.wix.com/en/article/accessing-your-sites-dashboard).

Each field heading shows the field name followed by the field ID in parentheses, in the format "fieldName (`fieldId`)".

The fields are listed in the same order as the collection's default order in the CMS.

#### ID (`_id`)

**Description:** Unique File ID. This is a system field and is hidden by default. This is the [Primary field](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#primary-fields).

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`

**Read-only:** Yes

#### Media Type (`mediaType`)

**Description:** The file's media type, such as image and document.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`

**Read-only:** Yes

#### Is Private (`isPrivate`)

**Description:** The file's privacy setting.

**Type:** Boolean

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`

**Read-only:** Yes

#### Size In Bytes (`sizeInBytes`)

**Description:** The file's size in bytes.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### MIME Type (`mimeType`)

**Description:** The file's mime type such as 'image/png', or 'audio/webm'.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### File URL (`fileUrl`)

**Description:** The file's Wix media URL.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

Example URL: `wix:image://v1/8b7eef_3deb121802514be7b698d0447559f9da~mv2.png/avatar-ga890ac591_1280.png#originWidth=1280&originHeight=1280`

#### Original File Name (`originalFileName`)

**Description:** The file's original file name.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Hash (`hash`)

**Description:** The file's checksum/hash.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Labels (`labels`)

**Description:** The file's labels assigned to the file by the Media Manager.

**Type:** Array of Strings

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Parent Folder ID (`parentFolderId`)

**Description:** The file's parent folder ID.

**Type:** String

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`

**Read-only:** Yes

#### Parent Folder (`parentFolder`)

**Description:** Reference to the file's parent folder item, as listed in the Folders collection.

**Type:** Reference

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Icon URL (`iconUrl`)

**Description:** The file icon's URL.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Icon Image (`iconImage`)

**Description:** The file's icon as an image.

**Type:** Image

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Source URL (`sourceUrl`)

**Description:** The file's source URL, such as an external link where the file was imported from.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Width (`width`)

**Description:** The file's width in pixels.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Height (`height`)

**Description:** The file's height in pixels.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Operation Status (`opStatus`)

**Description:** Status of the file being uploaded, for example, 'READY' or 'IN-QUEUE'.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Created Date (`_createdDate`)

**Description:** Date and time the file was created. This is a system field and is hidden by default.

**Type:** Date

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Updated Date (`_updatedDate`)

**Description:** Date and time the file was most recently updated (created or renamed). This is a system field and is hidden by default.

**Type:** Date

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** No

**Read-only:** Yes

## FileshareFiles

This section explains the permissions and fields available in the FileshareFiles collection.

> **Note:** When you add the [Wix File Share application](https://support.wix.com/en/article/wix-apps-about-the-file-share-app) to your site, the `FileshareFiles` collection is automatically added to your site.

To use the FileshareFiles collection in code, refer to it as `Media/FileshareFiles`.

::::tabs
:::REST_TAB
```
curl -X POST \
  'https://www.wixapis.com/wix-data/v2/items/query' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "dataCollectionId": "Media/FileshareFiles",
    "query": {}
  }'
```
:::
:::SDK_TAB
```js
import { items } from "@wix/data";

items.query("Media/FileshareFiles")
  .find()
  .then((results) => {
    // handle the results
  });
```
:::
::::

### Permissions

The FileshareFiles collection has the following [permissions](https://support.wix.com/en/article/cms-collection-permissions-overview):

- `read`: `ANYONE`
- `create`: None
- `update`: None
- `remove`: None

### Fields

This section describes each field in this collection and its properties.

> **Note:** This app collection contains read-only fields that cannot be managed from the collection. You can update the fields from the relevant app in your site’s [dashboard](https://support.wix.com/en/article/accessing-your-sites-dashboard).

Each field heading shows the field name followed by the field ID in parentheses, in the format "fieldName (`fieldId`)".

The fields are listed in the same order as the collection's default order in the CMS. 

#### Name (`name`)

**Description:** Name of file. This is the [Primary field](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#primary-fields).

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Owner (`_owner`)

**Description:** Unique identifier of the user who created the file. Can be a site owner, [collaborator](https://support.wix.com/en/article/roles-permissions-overview), or member. This is a system field and is hidden by default.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `hasSome`, `hasAll`, `contains`

**Read-only:** Yes

#### Date Created (`_createdDate`)

**Description:** The date and time the file was created. This is a system field and is hidden by default.

**Type:** Date

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Parent Folder (`parentFolder`)

**Description:** Reference to the file's parent folder, as listed in the [FileshareFolders](#filesharefolders) collection.

**Type:** Reference

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** Yes

**Read-only:** Yes

#### Path (`path`)

**Description:** Array of objects representing the full path from root to the parent folder of the file.

**Type:** JSON

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

```json
[
  {
    "id": "f3788ddf-8615-4ea9-8baf-db57252f89d7", 
    "name": "/"
  }, 
  {
    "id": "7b1a6e48-56fd-4e33-ba2e-39fe1227190f",
    "name": "pictures"
  }
]
```

#### Favorite Count (`favoriteCount`)

**Description:** The number of times the file was marked as a favorite. Both site members and visitors can mark a file as a favorite.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Favorite (`favorite`)

**Description:** Indicates whether the file was marked as a favorite by the current visitor.

**Type:** Boolean

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### View Count (`viewCount`)

**Description:** The number of times unique visitors viewed the file. Note that multiple views by the same visitor and downloading the file do not increment the view count.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Viewed (`viewed`)

**Description:** Indicates whether the current visitor viewed the file.

**Type:** Boolean

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Extension (`extension`)

**Description:** File extension. Examples: pdf, png.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Size (`size`)

**Description:** Size of the file in bytes.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### _id (`_id`)

**Description:** File ID. This is a system field and is hidden by default.

**Type:** Text

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`, `ne`, `hasSome`, `hasAll`, `contains`

**Read-only:** Yes

## FileshareFolders

This section explains the permissions and fields available in the FileshareFolders collection.

> **Note:** When you add the [Wix File Share application](https://support.wix.com/en/article/about-the-file-share-app) to your site, the `FileshareFolders` collection is automatically added to your site.

To use the FileshareFolders collection in code, refer to it as `Media/FileshareFolders`.

::::tabs
:::REST_TAB
```
curl -X POST \
  'https://www.wixapis.com/wix-data/v2/items/query' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "dataCollectionId": "Media/FileshareFolders",
    "query": {}
  }'
```
:::
:::SDK_TAB
```js
import { items } from "@wix/data";

items.query("Media/FileshareFolders")
  .find()
  .then((results) => {
    // handle the results
  });
```
:::
::::

### Permissions

The FileshareFolders collection has the following [permissions](https://support.wix.com/en/article/cms-collection-permissions-overview):

- `read`: `ANYONE`
- `create`: None
- `update`: None
- `remove`: None

### Fields

This section describes each field in this collection and its properties.

> **Note:** This app collection contains read-only fields that cannot be managed from the collection. You can update the fields from the relevant app in your site’s [dashboard](https://support.wix.com/en/article/accessing-your-sites-dashboard).

Each field heading shows the field name followed by the field ID in parentheses, in the format "fieldName (`fieldId`)".

The fields are listed in the same order as the collection's default order in the CMS. 

#### Name (`name`)

**Description:** Name of folder. This is the [Primary field](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#primary-fields).

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Owner (`_owner`)

**Description:** Unique identifier of the user who created the folder. Can be a site owner, [collaborator](https://support.wix.com/en/article/roles-permissions-overview), or member. This is a system field and is hidden by default.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `hasSome`, `hasAll`, `contains`

**Read-only:** Yes

#### Date Created (`_createdDate`)

**Description:** The date and time the folder was created. This is a system field and is hidden by default.

**Type:** Date

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Parent Folder (`parentFolder`)

**Description:** Reference to the folder's parent folder, as listed in this collection.

**Type:** Reference

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** Yes

**Read-only:** Yes

#### Path (`path`)

**Description:** Array of objects representing the full path from root to folder.

**Type:** JSON

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

```json
[
  {
    "id": "f3788ddf-8615-4ea9-8baf-db57252f89d7", 
    "name": "/"
  }, 
  {
    "id": "7b1a6e48-56fd-4e33-ba2e-39fe1227190f",
    "name": "pictures"
  }
]
```

#### Favorite Count (`favoriteCount`)

**Description:** The number of times the folder was marked as a favorite. Both site members and visitors can mark a folder as a favorite.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Favorite (`favorite`)

**Description:** Indicates whether the folder was marked as a favorite by the current visitor.

**Type:** Boolean

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### View Count (`viewCount`)

**Description:** The number of times unique visitors viewed (drilled down to) the folder. Note that multiple views by the same visitor and downloading the folder do not increment the view count.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Viewed (`viewed`)

**Description:** Indicates whether the current visitor viewed (drilled down to) the folder.

**Type:** Boolean

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Children Count (`childrenCount`)

**Description:** The number of files and folders directly inside this folder. Note that subfolder children are not included in the count.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### Last Modified (`lastModified`)

**Description:** Date and time the folder was most recently changed (created or renamed). Note that subfolder activity does not affect this field.

**Type:** Date

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `hasAll`, `contains`, `startsWith`, `endsWith`

**Read-only:** Yes

#### _id (`_id`)

**Description:** Folder ID. This is a system field and is hidden by default.

**Type:** Text

**Can connect to data:** No

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`, `ne`, `hasSome`, `hasAll`, `contains`

**Read-only:** Yes

## Folders

This section explains the permissions and fields available in the Folders collection.

> **Note:** When you add a file from your Media Manager to your site, the `Folders` collection is automatically added to your site.

To use the Folders collection in code, refer to it as `Media/Folders`.

::::tabs
:::REST_TAB
```
curl -X POST \
  'https://www.wixapis.com/wix-data/v2/items/query' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "dataCollectionId": "Media/Folders",
    "query": {}
  }'
```
:::
:::SDK_TAB
```js
import { items } from "@wix/data";

items.query("Media/Folders")
  .find()
  .then((results) => {
    // handle the results
  });
```
:::
::::

> **Note:** When using this collection, you can't set up the site to [link to the next or previous dynamic page](https://support.wix.com/en/article/linking-to-a-dynamic-page#linking-to-the-next-or-previous-dynamic-page).

### Permissions

The Folders collection has the following [permissions](https://support.wix.com/en/article/cms-collection-permissions-overview):

- `read`: `ANYONE`
- `create`: None
- `update`: None
- `remove`: None

### Fields

This section describes each field in this collection and its properties.

> **Note:** This app collection contains read-only fields that cannot be managed from the collection. You can update the fields from the relevant app in your site’s [dashboard](https://support.wix.com/en/article/accessing-your-sites-dashboard).

Each field heading shows the field name followed by the field ID in parentheses, in the format "fieldName (`fieldId`)".

The fields are listed in the same order as the collection's default order in the CMS. 

#### ID (`_id`)

**Description:** Unique ID of the folder. Same as Folder ID. This is a system field and is hidden by default.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`

**Read-only:** Yes

#### Folder ID (`folderId`)

**Description:** Unique Folder ID. Same as ID. This is the [Primary field](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#primary-fields).

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`

**Read-only:** Yes

#### Folder Name (`folderName`)

**Description:** Unique name of the folder.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** No

**Read-only:** Yes

#### Parent Folder ID (`parentFolderId`)

**Description:** The folder's parent folder ID.

**Type:** String

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`

**Read-only:** Yes

#### Created Date (`_createdDate`)

**Description:** Date and time the folder was created. This is a system field and is hidden by default.

**Type:** Date

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Updated Date (`_updatedDate`)

**Description:** Date and time the folder was most recently updated (created or renamed). This is a system field and is hidden by default.

**Type:** Date

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** No

**Read-only:** Yes