> For the complete documentation index, see [llms.txt](https://usermanual.ergonode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://usermanual.ergonode.com/resources/media.md).

# Media

Upload and organize media files in a folder tree, switch the view, filter files, and check which file types Ergonode supports.

The current view is built around a folder tree on the left and a file list on the right, with top-level controls for uploading, creating folders, switching view mode, and filtering content.

Ergonode supports the following file types in Media:

| Category            | Extensions                                                  |
| ------------------- | ----------------------------------------------------------- |
| 3D / CAD Formats    | 3ds, dwf, dwg, dxf, fbx, glb, obj, skp, stp, igs, plt, hpgl |
| Vector Graphics     | ai, eps, svg, cdr                                           |
| Raster Images       | bmp, gif, jpeg, jpg, png, tif, tiff, webp, avif, heic, hdr  |
| Animation / Motion  | mkv, mov, mp4, webm, wmv, hevc                              |
| Documents           | doc, docx, odt, pdf, txt                                    |
| Spreadsheets        | csv, ods, xls, xlsx                                         |
| Presentations       | ppt, pptx, key                                              |
| Adobe / Design Apps | psd, indd, indt                                             |
| Special Packages    | ggpkg                                                       |
| Archive Formats     | zip                                                         |
| 3D Software Scenes  | max, usdz, vrm                                              |

{% hint style="info" %}
The max allowed file size is 100MB
{% endhint %}

{% hint style="info" %}
The maximum file name with extension and folder name is 128 characters.
{% endhint %}

## Interface overview

The Media screen contains:

* A left navigation sidebar with access to Folders, Media attributes, and System attributes.
* A folder tree that can be used to browse and manage the media structure.
* A title bar with ***Flat mode***, ***New folder*** and ***Upload***, and a grid bar with ***Views***, the view icons, the ***settings (gear)*** icon and ***Filters***.
* A main file list showing folders and files in the selected location.

The content area supports a table-style view with columns such as preview, name, size, created at, and extension.

Search, sorting and moving columns work as described in [Table view (Grid view)](https://usermanual.ergonode.com/products/catalog/system-views/table-view-grid-view). You can also add or remove columns by drag-and-drop from Media attributes and System attributes in the sidebar. The icons in the column titles work as in the [Catalog](https://usermanual.ergonode.com/products/catalog).

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2Fg8slf8WsYvcHDDegYBu7%2Ffab35f0fe6c1.png?alt=media&#x26;token=d60228c9-a09c-45c1-89d3-ce6665dd4d58" alt=""><figcaption></figcaption></figure>

The file list shows both folders and files in the selected location, or everything when the **Flat mode** is ON.

Pagination controls at the bottom of the list allow you to move through multiple pages of results, and the interface also lets you choose how many items are shown per page.

## Search, filters, views, and batch actions

The top bar includes Views, the view icons, a settings icon, and Filters for managing and refining the displayed content. Batch actions appear in this bar only after you select files in the grid.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FXWFnWa6RRnTGxOjX6LTN%2F4f913194e5cc.png?alt=media&#x26;token=a1041058-e3bd-4aa1-9c2d-05717866d632" alt=""><figcaption></figcaption></figure>

### Search

The interface includes a search row inside the table, allowing you to search within visible columns such as file name and size (simple search). 

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FoFAtPq35iVmagOvxY65L%2F9fee18028922.png?alt=media&#x26;token=021d5016-5e52-459d-a246-09e2e1b0fa6a" alt=""><figcaption></figcaption></figure>

### Filters

***Filters*** work in the same way as they do in the Products catalog. For more information, see [Advanced filters](https://usermanual.ergonode.com/products/catalog/filters-advanced).

Click ***Filters*** in the top bar to open the Filters side panel. Use ***Add filter*** to add a filter, or add an attribute directly from the attributes panel on the left. ***Clear*** and ***Remove*** are available in the upper part of the panel.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F6yQXLNrC5g4u8lYg0Ueb%2F72c9c87fac41.png?alt=media&#x26;token=fa82cc8e-9ec3-45f0-a6c8-b6292c12f60e" alt="" width="563"><figcaption></figcaption></figure>

### Views

The ***Views*** menu on the left of the grid bar allows saving and switching between [Custom views](https://usermanual.ergonode.com/products/catalog/system-views/custom-views) and works exactly the same as on the Products catalog (see [System views](https://usermanual.ergonode.com/products/catalog/system-views)).

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F7iM7DEHuVb427PMlwrHh%2F5e97cb64bd3c.png?alt=media&#x26;token=16b2b3e8-acf9-4d39-b2f5-8f232cd3da8d" alt=""><figcaption></figcaption></figure>

The following icons allow for a fast switch between grid and tiles view, those are predefined and cannot be modified nor deleted.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FBbwmTmwNd5CFm3AJO9r2%2F90e8431d1ae5.png?alt=media&#x26;token=1e340546-84ee-451d-9e40-ade1a2446739" alt=""><figcaption></figcaption></figure>

The ***settings (gear)*** icon opens the [Display settings](https://usermanual.ergonode.com/products/catalog/system-views/display-settings).

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F7xzatA6XYKjXEd3u1B2I%2Fimage.png?alt=media&#x26;token=b54fe484-4a1e-4895-99a0-4f2a51b352da" alt="" width="528"><figcaption></figcaption></figure>

\
Per-file actions are shown on the right side of each row: the ***download*** icon, the ***edit (pen)*** icon and the ***three dots*** menu with Edit, Download, Copy link, Replace file, Move, Properties, Relations, and Delete. ***Download*** opens a submenu with ***Original*** and ***Media profiles*** (see [Media profiles](https://usermanual.ergonode.com/system/settings/media-profiles)). ***Properties*** and ***Relations*** show the information of the [Properties](https://usermanual.ergonode.com/resources/media/edit/properties) and [Relations](https://usermanual.ergonode.com/resources/media/edit/relations) tabs in a window over the grid.

Folder rows have the ***folder*** icon, which opens the folder, and the ***three dots*** menu with Open, Rename, Move, and Delete.

{% hint style="info" %}
"File replace" is supported for up to 100 relations. Exceeding this limit will cause the process to fail.
{% endhint %}

### Batch actions

{% hint style="info" %}
Batch action works in the background. When it's done, you will have a new notification in the [Action center](https://usermanual.ergonode.com/dashboard/dashboard/user-menu-and-action-center/action-center) (the bell icon in the top right corner).
{% endhint %}

To use batch actions, select files by ticking their checkboxes in the grid. The top bar will then show the number of selected files, the ***Clear selection*** icon, ***Edit***, ***AI Actions***, and ***Delete***.

Available media Batch actions:

| Action                    | Option                | Sub-options                                                                                    | Extra informations                                                                                       |
| ------------------------- | --------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Edit > Attribute values   | Change values         |                                                                                                | Change attribute values and remove existing ones                                                         |
|                           | Add prefix or suffix  |                                                                                                | Add text at the beginning or end of the attribute value                                                  |
|                           | Add values            |                                                                                                | Add more attribute values and keep the existing ones                                                     |
|                           | Remove values         |                                                                                                | Remove specific attribute values and keep the others                                                     |
|                           | Clear values          |                                                                                                | Completely clear the attribute values and leave them blank                                               |
| Edit > Move media         |                       |                                                                                                | with option "Duplicate in case of name conflict"                                                         |
| Edit > Assign to products | Starts with...        | <ul><li>Replace existing media\*</li><li>Re-sort all attribute values by file name\*</li></ul> | Automatically assign media to products by matching file names with product data when conditions are met. |
|                           | Ends with...          | <ul><li>Replace existing media\*</li><li>Re-sort all attribute values by file name\*</li></ul> |                                                                                                          |
|                           | Is exactly...         | <ul><li>Replace existing media\*</li><li>Re-sort all attribute values by file name\*</li></ul> |                                                                                                          |
| Edit > AI generated       | Yes / No              |                                                                                                | Mark the selected images as AI-generated or not, or leave the field empty to clear the value             |
| AI Actions                | Complete attributes   |                                                                                                | Fill the selected media attributes with AI, based on each image                                          |
|                           | Generate names        |                                                                                                | Create media names with AI for text attribute, using custom prompt and attribute variables               |
|                           | Generate descriptions |                                                                                                | Create media descriptions with AI for textarea attribute, using custom prompt and attribute variables    |
|                           | Translate content     |                                                                                                | Translate media attribute values with AI                                                                 |
|                           | Generate titles       |                                                                                                | Create an SEO-friendly title for each image with AI                                                      |
|                           | Generate alt text     |                                                                                                | Describe each image with AI for SEO and accessibility                                                    |
| Delete                    |                       |                                                                                                | Media are deleted in background and cannot have any relations (be used as atribute value) to be deleted. |

*\*Sub-option availability is subject to the attribute type.*

{% hint style="info" %}
The AI Actions ***Complete attributes***, ***Generate titles*** and ***Generate alt text*** work on images only (JPG, PNG, WEBP, GIF); other files are skipped. ***Complete attributes*** overwrites existing values of the attributes you select (image, gallery, file, date and product relation attributes aren't supported); global attributes are filled for all languages. ***Generate titles*** saves the result in the ***Title*** field and ***Generate alt text*** in the ***Alternate text*** field. Each of them asks for a ***Language*** and an ***AI Model***, then for a confirmation with ***Start batch action***. In the Action center and in [Batch actions](https://usermanual.ergonode.com/system/activities/batch-actions) they show as ***Complete media attributes***, ***Generate media titles*** and ***Generate media alt text***.
{% endhint %}

To fill media attributes with AI, select the images, click ***AI Actions*** and choose ***Complete attributes***.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FO498Zgakn1qljhxVqt1L%2Fmedia-complete-attributes-form.png?alt=media&#x26;token=d5e2b5bf-1259-42ae-b51a-b3d225f13fc1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Matching rules:

• You can use a maximum of one attribute.

• Only unique attributes can be used.

• File extensions are ignored.

• Matching is case-insensitive.
{% endhint %}

To assign media to products, select the files, click ***Edit*** and choose ***Assign to products***.

Set a rule that matches the file names with product data. For example, to add SET\_003-Close\_up\_shot.jpeg to the gallery of the product with SKU SET\_003, choose ***Starts with...***, ***SKU*** and ***Dash (-)*** under ***If file name...***, and ***Gallery of images*** under ***Then assign to...***. Click ***Try out*** to check the rule on a selected file: it shows the matching pattern and the matched product. Then click ***Assign media***.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FLELKkFW0w2ndQosDC8cC%2F4461e1e21ea0.png?alt=media&#x26;token=ca26fed7-7b9c-4443-963f-2cde34ef5d6e" alt=""><figcaption></figcaption></figure>

The window's fields and buttons:

| Option                                            | Description                                                                                                                                                                                                                   | Additional information                                                                                                              |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Operator                                          | Where the product value is in the file name: ***Starts with...***, ***Ends with...*** or ***Is exactly...***                                                                                                                  | Required                                                                                                                            |
| Product attribute (under ***If file name...***)   | The product attribute whose value the file name holds                                                                                                                                                                         | Required. ***SKU*** or a unique product attribute, such as ***EAN***                                                                |
| Delimiter                                         | The character between the value and the rest of the file name: ***Dash (-)***, ***Underscore (\_)***, ***Dot (.)***, ***Comma (,)*** or ***Space ( )***                                                                       | Required. Only with ***Starts with...*** and ***Ends with...***                                                                     |
| Before, After                                     | The text before and after the value in the file name                                                                                                                                                                          | Optional. Only with ***Is exactly...***, instead of ***Delimiter***                                                                 |
| Product attribute (under ***Then assign to...***) | The attribute that gets the files, such as ***Main Image*** (image), ***Gallery of images*** (gallery) or ***Care instruction*** (file)                                                                                       | Required. New files are attached to existing ones in gallery and file attributes; existing images in image attributes are preserved |
| Attribute content languages                       | The content languages in which the attribute gets the files; you can pick several. The rule's summary at the bottom of the window then ends with the number of languages, for example "in 2 content languages"                | Required. Only when the attribute under ***Then assign to...*** is local                                                            |
| Replace existing media                            | Overwrites the current file                                                                                                                                                                                                   | Image attributes only                                                                                                               |
| Re-sort all attribute values by file name         | Orders the attribute's files alphabetically (A-Z)                                                                                                                                                                             | Gallery and file attributes only                                                                                                    |
| Try out                                           | Checks the rule on a selected file and shows the sample file, the matching pattern and the matched product. If the file name doesn't fit, it says why, for example "Sample file name does not contain a specified delimiter." | Assigns nothing                                                                                                                     |
| Assign media                                      | Starts the batch action; the button shows how many files you selected                                                                                                                                                         |                                                                                                                                     |

{% hint style="info" %}
***AI generated*** is a system attribute of media files (***Yes*** or ***No***). Like other system attributes, you can add it as a column and filter by it. Images from AI Photo Studio are marked automatically; mark other images manually, here or in the file's [General](https://usermanual.ergonode.com/resources/media/edit/general) tab. A media profile with ***Add watermark only to AI-generated images*** adds its watermark only to images marked ***Yes*** (see [Watermark](https://usermanual.ergonode.com/system/settings/media-profiles/watermark)).
{% endhint %}

To mark images as AI-generated, select the files, click ***Edit*** and choose ***AI generated***. The window's title shows how many images you selected. Under ***Change AI generated to:***, ***Yes*** is selected by default: keep it, choose ***No***, or click ***Clear*** in the list to leave the field empty and clear the value on all selected images. Then click ***Change value*** and confirm. In the Action center and in [Batch actions](https://usermanual.ergonode.com/system/activities/batch-actions) the action shows as ***Change AI generated in media***.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FbF9eZ4QD8flCaxZNtpcg%2Fmedia-ai-generated-form.png?alt=media&#x26;token=7bda6839-580e-4ded-81a6-623f87979077" alt=""><figcaption></figcaption></figure>

## Working with folders

{% hint style="info" %}
There is no limit on how many folders or how many branches the folder tree can have.
{% endhint %}

Use the folder tree on the left to browse the media structure. 

Folders can be nested, and expanded items in the tree reveal child folders below their parent. 

To create a new folder, use the New folder button in the top-right corner or the green plus button visible near the bottom of the sidebar.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F9wSWYMk6WlVhmF8tFvei%2F71b3b33b8458.png?alt=media&#x26;token=1aa3ae11-7054-454d-9c02-62042410fe19" alt=""><figcaption></figcaption></figure>

\
Folder actions appear in the menu next to each folder name in the tree. These include opening, creating, renaming, deleting folders, and moving them within the structure. 

Folder names must be unique within the same parent level: you cannot have two “Watches” folders directly under “Media,” but nested “Watches” subfolders are allowed.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FQoNnSjVNu1UfgQGhh6mt%2F918dfd38686b.png?alt=media&#x26;token=3c58a858-8fcb-4562-a0e6-705f774fc0c4" alt=""><figcaption></figcaption></figure>

## Uploading files

{% hint style="info" %}
You can only upload 50 files via the UI at once.
{% endhint %}

To add new media, click ***Upload*** in the top-right corner. In the ***Add resources*** window, choose the target folder in the folder tree on the left, then drag files onto the window or click to browse. If no specific folder is selected during upload, files are uploaded to the main folder.

When the upload is completed, you will see a confirmation on each file or information about errors if something went wrong.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FEb8CGJcdOqYqkXYm0Q3x%2Fa8802d1fe982.png?alt=media&#x26;token=b920d868-6af1-48dd-925c-386a315f1ce2" alt=""><figcaption></figcaption></figure>


---

# 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://usermanual.ergonode.com/resources/media.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.
