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). Additionally, a multi-valued attribute with a single field of type PMediaBank6File also supports dropping multiple files at once:

Multi-valued attribute

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

Note

A multi-valued attribute containing more fields than a single PMediaBank6File still supports drag & drop upload, just not for multiple files at once.

Limitations

Availability

Drag & drop file upload is only available for single valued attribute fields that do not yet have a value. For multi valued attributes, files can be appended using the drag & drop function at all times.

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. It is currently not possible to change this order in the user interface.

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