Skip to content

How to replace DAM file reference

The DAM file replacement feature allows you to replace a file in DAM while automatically updating all references to that file across your PIM products. This ensures consistency throughout your product catalog without manually updating each product individually.

For more information about file references and DAM integration, see our DAM concepts documentation.

Prerequisites

To be able to replace files references in for example products, your solution must include both PIM and DAM. And you should also be on the latest version of the Bizzkit Commerce Cloud.

Setting up file references in PIM

In PIM, you can reference files from the Digital Asset Management system by creating attributes with the field type PMediaBank6File. Here's how to set up file references:

  1. Create a single or multi-valued attribute with field type PMediaBank6File
  2. Add the attribute to your product
  3. Select a file reference by either:
  4. Uploading from your local machine (which uploads the file to DAM and places it in a specified folder)
  5. Selecting an existing file from DAM

Once uploaded, you have a DAM reference that can be used with the file replace feature.

How to replace a DAM file

Follow these steps to replace a DAM file and update all product references:

  1. Navigate to DAM and locate the file you want to replace
  2. Click on the three dots to spawn a context menu
  3. Click replace and follow the replace flow

Replace file in DAM

File replacement interface in DAM

Processing time

The file replacement process is not instant. Depending on the number of references (products or categories using the file), this process can take considerable time. For simple examples with few references, changes may be visible almost immediately, whereas if the file is used extensively (such as a logo referenced by thousands of products), full propagation may take some time.

Understanding the replacement process

The DAM-PIM file replacement integration works differently from DAM's internal file replacement feature. Even though they are triggered at the same time.

DAM internal replacement

  • Handles redirects in the case old url is used
  • Copies attributes that were on the file that was replaced
  • No cache invalidation provided
  • Cached values may persist for up to a year
  • Sends the webhook out that a file has been replaced

DAM-PIM integration replacement

  • Completely replaces references throughout the system
  • Propagates changes to resolved product views
  • Does the equivalent of opening the file changing the image and saving it

Supported attribute types

The file replacement feature currently supports:

  • Single-valued attributes with field type PMediaBank6File
  • Multi-valued attributes with field type PMediaBank6File

Limitations

The following attribute types are not currently supported:

Verifying the replacement

After initiating a file replacement, you can verify that the change has been applied:

  1. Navigate to a product that used the original file
  2. Check that the product now displays the new file