Import PIM assets

  • Updated

Import assets

Import assets one at a time or in bulk. You can add asset tags and file name prefixes. Avoid duplicate assets by overwriting existing assets with the same file name.

  • PIM automatically resizes imported images for optimal site performance, creating small, medium, and large URLs for each image.
  • You can configure the sizes in settings. The default is 160 x 160 px for small, 300 x 300 px for medium, and 900 x 900 px for large.
  • Your image retains its aspect ratio when resized. For example, if the original image has 1800 x 1200 px dimensions, retaining the 3:2 ratio resizes the image to 900 x 600 px for the large size.

The PIM supports importing 360-degree images using the external asset import template. You must select 360 Degree Image in the Asset Type column and include the image URL in the Other Asset URL column.

  1. Click Assets.
  2. Click Import, select the assets you want to import, and click Open. You can also drag and drop them from your file explorer into the upload area.
  3. Use the Asset Import page to:
    • Select a Destination Folder for these assets. The system selects this by default if you are already in a folder.
    • Select the Language for these assets.
    • Toggle the Overwrite Files option on or off. If on, the import process overwrites existing assets if new assets have the same file name. If off, the import does not process duplicates and asks if you want to proceed with the import. Suppose the overwritten assets were assigned to any products or categories. In that case, the status of the product or categories is updated to ensure the new asset displays on your site the next time the categories and products are published.
    • Add Asset Tags to these assets to further categorize assets and allow filters. Auto-complete helps you find existing tags or create a new tag. Hover over a tag and click the X to remove it.
    • Add Prefix to these assets.
    • Toggle the Auto-assign to products option on or off.
    • View the File Types Detected. This is a list of the file types included in this import.

    import-assets.png

  4. Click Process to start your import.
  5. View your import progress at the top of the Assets list page or click Cancel to stop it.

You cannot import more assets until the PIM finishes processing.

When you import assets, the asset file names are hashed (for example, h92f13cj90375wp_nm.jpg) to ensure a unique static URL for each image file. This is important for asset versioning logic and lets users change the asset name without altering the underlying URL. Using hashed names and obfuscating the S3 location also prevents images from being crawled or browsed by external users. This may affect SEO results for the images, but it should not affect the SEO results for product detail pages. If you have SEO concerns, you can choose to host the assets externally using a cloud storage provider where you have full control over naming conventions. Externally hosted assets can be imported into PIM through spreadsheet import and managed as directly hosted.

Import external assets

You can import, organize, and assign digital assets hosted outside of PIM to products or categories the same as other assets. You can also convert the external assets to hosted assets in the PIM. Use the provided import template to import or update externally hosted assets in the PIM.

  • PIM does not automatically resize these assets unless you convert them to hosted assets.
  • Higher resolution and size images may affect your site performance if they are used where smaller images are optimal. For example, if you use URLs for high-resolution images like the small image, the product list page may load slowly.
  • Assets must have unique names.
  • Place the image URL in the Other Asset URL column if you import 360-degree images. 
  1. Click Imports. The Imports list page displays.  
  2. Click Import Template and Download the Externally Hosted Assets template if you have not already formatted your import file. 
    • Folder – The location of the asset within the PIM's digital asset management folder structure.
    • Name – The name of the asset.
    • Asset Type – The type of asset: Image, 360 Degree Image, or Other Asset.
  3. Drag and drop the file onto the Imports page. You can also click Import, locate your file, and click Open.
  4. Set the Import Type to Externally Hosted Assets
  5. Click Import. If you receive any validation errors, resolve them before importing again. You can download the provided file to view error messages specific to each row.
  6. View your import progress on the Imports list page. A log of the import also displays on the page when it is complete.
If you did not specify an import file, the PIM places the assets in the Uncategorized assets folder.