Skip to content

Drag & drop file upload

Drag & drop file upload enables a seamless user experience between PIM and DAM, as users are able to upload product images and other files to DAM through the PIM user interface.

Single-valued attribute

Single-valued attribute with DAM file reference

Feature highlights

  • Directly upload files to Bizzkit DAM through the PIM product details page.
  • Upload multiple files simultaneously is supported, using multi-valued attributes.
  • Configure the upload destination, which allows for controlling to which DAM folder files are uploaded.

Configuration

A file upload location must be configured on the PIM API, before the drag & drop functionality becomes available in the UI. This is done by setting a DAM folder id on the following PIM API endpoint: PATCH /api/settings.

Setting the DAM file upload folder

1
2
3
4
5
{
    "damDropFolder": {
        "folderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
}

Tip

The folder id can be obtained by navigating to the desired folder in DAM and copying the folder id from the URL:

Obtaining a folder id in DAM
Obtaining a folder id in DAM

Supported attribute types

The drag & drop upload functionality is available for fields of type PMediaBank6File (a DAM file reference) and its segmented variants. Furthermore, when multiple files are dropped into a multi valued attribute field of compatible type, the additional values will be automatically included as new items in multi value collection.

Multi-valued attribute

Multi-valued attribute with DAM file references and option to add more files

Limitations

DAM permissions and file size

When uploading files using the drag & drop upload feature, you are subject to the same restrictions, such as folder permissions and file size, as if you are uploading files to the DAM system yourself. Check DAM documentation for more details.

Order of listed files

For multi-valued attributes, the files will be appended to any existing value. This means that the order of files is determined by the order in which files are added and uploaded to the attribute.

Selecting already uploaded files

Whenever a file and dropped in the attribute field, it will always be uploaded as a new file regardless if it had been uploaded before. For these cases, one can instead pick the existing file from DAM:

Pick a file from DAM

Pick a file from DAM